Class Autofit
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Ajustar automaticamente
Descreve as configurações de ajuste automático de uma forma. Se uma mudança for feita que possa afetar o ajuste do texto
dentro da caixa de texto delimitadora:
- O ajuste automático é desativado e definido como
AutofitType.NONE
.
- A escala da fonte é redefinida para o valor padrão e aplicada ao tamanho da fonte.
- A redução do espaçamento entre linhas é redefinida para o valor padrão e aplicada ao espaçamento entre linhas.
Documentação detalhada
disableAutofit()
Define o AutofitType
de uma forma como AutofitType.NONE
.
Retornar
Autofit
: o ajuste automático para encadeamento.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getAutofitType()
Recebe o AutofitType
da forma.
Retornar
AutofitType
: o tipo de ajuste automático.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getFontScale()
Recebe a escala da fonte aplicada à forma. Para formas com AutofitType
AutofitType.NONE
ou AutofitType.SHAPE_AUTOFIT
, esse valor é o padrão 1.
Para AutofitType.TEXT_AUTOFIT
, o valor retornado é o valor pelo qual o tamanho da fonte original é
multiplicado para caber na forma.
Retornar
Number
: a escala da fonte.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getLineSpacingReduction()
Recebe a redução do espaçamento entre linhas aplicada à forma. Para formas com AutofitType
AutofitType.NONE
ou AutofitType.SHAPE_AUTOFIT
, esse valor é o padrão
0. Para AutofitType.TEXT_AUTOFIT
, o valor retornado é a quantidade de espaçamento
subtraída do espaçamento original para que o texto caiba na forma.
Retornar
Number
: o espaçamento entre linhas.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-07-26 UTC.
[null,null,["Última atualização 2025-07-26 UTC."],[[["\u003cp\u003eAutofit settings determine how text adjusts within a shape's boundaries in Google Slides, and when modified, the settings reset to defaults, impacting font scale and line spacing.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can utilize methods like \u003ccode\u003edisableAutofit()\u003c/code\u003e, \u003ccode\u003egetAutofitType()\u003c/code\u003e, \u003ccode\u003egetFontScale()\u003c/code\u003e, and \u003ccode\u003egetLineSpacingReduction()\u003c/code\u003e to manage the Autofit behavior of shapes programmatically.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003egetFontScale()\u003c/code\u003e and \u003ccode\u003egetLineSpacingReduction()\u003c/code\u003e methods return default values for shapes with AutofitType.NONE or AutofitType.SHAPE_AUTOFIT, while for AutofitType.TEXT_AUTOFIT, they reflect adjustments made to fit text within the shape.\u003c/p\u003e\n"],["\u003cp\u003eAll provided methods necessitate authorization with specific scopes like \u003ccode\u003ehttps://www.googleapis.com/auth/presentations.currentonly\u003c/code\u003e or \u003ccode\u003ehttps://www.googleapis.com/auth/presentations\u003c/code\u003e for scripts to function correctly.\u003c/p\u003e\n"]]],[],null,["# Class Autofit\n\nAutofit\n\nDescribes the autofit settings of a shape. If a change is made that might affect text fitting\nwithin its bounding text box:\n\n- Autofit is deactivated and set to [AutofitType.NONE](/apps-script/reference/slides/autofit-type#NONE).\n- The font scale is reset to the default value and applied to the font size.\n- The line spacing reduction is reset to the default value and applied to the line spacing. \n\n### Methods\n\n| Method | Return type | Brief description |\n|---------------------------------------------------------|-----------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------|\n| [disableAutofit()](#disableAutofit()) | [Autofit](#) | Sets the [AutofitType](/apps-script/reference/slides/autofit-type) of a shape to [AutofitType.NONE](/apps-script/reference/slides/autofit-type#NONE). |\n| [getAutofitType()](#getAutofitType()) | [AutofitType](/apps-script/reference/slides/autofit-type) | Gets the [AutofitType](/apps-script/reference/slides/autofit-type) of the shape. |\n| [getFontScale()](#getFontScale()) | `Number` | Gets the font scale applied to the shape. |\n| [getLineSpacingReduction()](#getLineSpacingReduction()) | `Number` | Gets the line spacing reduction applied to the shape. |\n\nDetailed documentation\n----------------------\n\n### `disable``Autofit()`\n\nSets the [AutofitType](/apps-script/reference/slides/autofit-type) of a shape to [AutofitType.NONE](/apps-script/reference/slides/autofit-type#NONE).\n\n#### Return\n\n\n[Autofit](#) --- The autofit, for chaining.\n\n#### Authorization\n\nScripts that use this method require authorization with one or more of the following [scopes](/apps-script/concepts/scopes#setting_explicit_scopes):\n\n- `https://www.googleapis.com/auth/presentations.currentonly`\n- `https://www.googleapis.com/auth/presentations`\n\n*** ** * ** ***\n\n### `get``Autofit``Type()`\n\nGets the [AutofitType](/apps-script/reference/slides/autofit-type) of the shape.\n\n#### Return\n\n\n[AutofitType](/apps-script/reference/slides/autofit-type) --- The autofit type.\n\n#### Authorization\n\nScripts that use this method require authorization with one or more of the following [scopes](/apps-script/concepts/scopes#setting_explicit_scopes):\n\n- `https://www.googleapis.com/auth/presentations.currentonly`\n- `https://www.googleapis.com/auth/presentations`\n\n*** ** * ** ***\n\n### `get``Font``Scale()`\n\nGets the font scale applied to the shape. For shapes with [AutofitType](/apps-script/reference/slides/autofit-type) [AutofitType.NONE](/apps-script/reference/slides/autofit-type#NONE) or [AutofitType.SHAPE_AUTOFIT](/apps-script/reference/slides/autofit-type#SHAPE_AUTOFIT), this value is the default value of 1.\nFor [AutofitType.TEXT_AUTOFIT](/apps-script/reference/slides/autofit-type#TEXT_AUTOFIT), the value returned is what the original font size is\nmultiplied by to fit within the shape.\n\n#### Return\n\n\n`Number` --- The font scale.\n\n#### Authorization\n\nScripts that use this method require authorization with one or more of the following [scopes](/apps-script/concepts/scopes#setting_explicit_scopes):\n\n- `https://www.googleapis.com/auth/presentations.currentonly`\n- `https://www.googleapis.com/auth/presentations`\n\n*** ** * ** ***\n\n### `get``Line``Spacing``Reduction()`\n\nGets the line spacing reduction applied to the shape. For shapes with [AutofitType](/apps-script/reference/slides/autofit-type)\n[AutofitType.NONE](/apps-script/reference/slides/autofit-type#NONE) or [AutofitType.SHAPE_AUTOFIT](/apps-script/reference/slides/autofit-type#SHAPE_AUTOFIT), this value is the default value\nof 0. For [AutofitType.TEXT_AUTOFIT](/apps-script/reference/slides/autofit-type#TEXT_AUTOFIT), the returned value is the amount of spacing\nsubtracted from the original spacing to make the text fit within the shape.\n\n#### Return\n\n\n`Number` --- The line spacing.\n\n#### Authorization\n\nScripts that use this method require authorization with one or more of the following [scopes](/apps-script/concepts/scopes#setting_explicit_scopes):\n\n- `https://www.googleapis.com/auth/presentations.currentonly`\n- `https://www.googleapis.com/auth/presentations`"]]