Class Autofit
Stay organized with collections
Save and categorize content based on your preferences.
Autofit
Describes the autofit settings of a shape. If a change is made that might affect text fitting
within its bounding text box:
- Autofit is deactivated and set to
AutofitType.NONE.
- The font scale is reset to the default value and applied to the font size.
- The line spacing reduction is reset to the default value and applied to the line spacing.
Detailed documentation
disableAutofit()
Sets the AutofitType of a shape to AutofitType.NONE.
Return
Autofit — The autofit, for chaining.
Authorization
Scripts that use this method require authorization with one or more of the following scopes:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getAutofitType()
Gets the AutofitType of the shape.
Return
AutofitType — The autofit type.
Authorization
Scripts that use this method require authorization with one or more of the following scopes:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getFontScale()
Gets the font scale applied to the shape. For shapes with AutofitType AutofitType.NONE or AutofitType.SHAPE_AUTOFIT, this value is the default value of 1.
For AutofitType.TEXT_AUTOFIT, the value returned is what the original font size is
multiplied by to fit within the shape.
Return
Number — The font scale.
Authorization
Scripts that use this method require authorization with one or more of the following scopes:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getLineSpacingReduction()
Gets the line spacing reduction applied to the shape. For shapes with AutofitType
AutofitType.NONE or AutofitType.SHAPE_AUTOFIT, this value is the default value
of 0. For AutofitType.TEXT_AUTOFIT, the returned value is the amount of spacing
subtracted from the original spacing to make the text fit within the shape.
Return
Number — The line spacing.
Authorization
Scripts that use this method require authorization with one or more of the following scopes:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-12-02 UTC.
[null,null,["Last updated 2024-12-02 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`"]]
