Class Autofit
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
الملاءمة التلقائية
يصف إعدادات "الملاءمة التلقائية" لشكل معيّن. في حال إجراء تغيير قد يؤثر في احتواء النص
داخل مربّع النص الحدودي:
- يتم إيقاف ميزة "الملاءمة التلقائية" وضبطها على
AutofitType.NONE.
- تتم إعادة ضبط مقياس الخط على القيمة التلقائية ويتم تطبيقه على حجم الخط.
- تتم إعادة ضبط القيمة المُخفضة لتباعد الأسطر على القيمة التلقائية ويتم تطبيقها على تباعد الأسطر.
مستندات تفصيلية
disableAutofit()
لضبط AutofitType لشكل على AutofitType.NONE
الإرجاع
Autofit - ميزة "الملاءمة التلقائية" لربط العناصر
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getAutofitType()
تحصل على AutofitType الشكل.
الإرجاع
AutofitType: نوع الاحتواء التلقائي
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getFontScale()
تحصل على مقياس الخط الذي تم تطبيقه على الشكل. بالنسبة إلى الأشكال التي تحتوي على AutofitType AutofitType.NONE أو AutofitType.SHAPE_AUTOFIT، تكون هذه القيمة هي القيمة التلقائية 1.
بالنسبة إلى AutofitType.TEXT_AUTOFIT، تكون القيمة المعروضة هي القيمة التي يتم ضرب حجم الخط الأصلي فيها
لتناسب الشكل.
الإرجاع
Number - مقياس الخط
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getLineSpacingReduction()
تحصل على التخفيض في تباعد الأسطر الذي تم تطبيقه على الشكل. بالنسبة إلى الأشكال التي تحتوي على AutofitType
AutofitType.NONE أو AutofitType.SHAPE_AUTOFIT، تكون هذه القيمة هي القيمة التلقائية
0. بالنسبة إلى AutofitType.TEXT_AUTOFIT، تكون القيمة المعروضة هي مقدار المسافة
المُقتطعة من المسافة الأصلية لكي يتلاءم النص مع الشكل.
الإرجاع
Number: تباعد الأسطر
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\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`"]]
