Class SlidesApp

تطبيقالعروض التقديمية من Google

ينشئ Presentations قابلاً للتعديل ويفتحه. 

// Open a presentation by ID.
let preso = SlidesApp.openById('PRESENTATION_ID_GOES_HERE');

// Create and open a presentation.
preso = SlidesApp.create('Presentation Name');

الخصائص

الموقعالنوعالوصف
AlignmentPositionAlignmentPositionتعداد لأنواع مواضع المحاذاة.
ArrowStyleArrowStyleتعداد لأنماط الأسهم المختلفة التي يمكن أن يحتوي عليها Line.
AutoTextTypeAutoTextTypeتعداد لأنواع النص التلقائي.
AutofitTypeAutofitTypeتعداد لأنواع الملء التلقائي.
CellMergeStateCellMergeStateتعداد لحالات الدمج المختلفة لخلية جدول.
ColorTypeColorTypeتعداد لأنواع الألوان.
ContentAlignmentContentAlignmentتعداد للقيم المستخدَمة لتحديد محاذاة المحتوى
DashStyleDashStyleتعداد لأنماط الشرطات المختلفة التي يمكن أن يحتوي عليها Line.
FillTypeFillTypeتعداد لأنواع الملء.
LineCategoryLineCategoryتعداد لفئات Line.
LineFillTypeLineFillTypeتعداد لأنواع LineFill.
LineTypeLineTypeتعداد لأنواع Line.
LinkTypeLinkTypeتعداد لأنواع الروابط
ListPresetListPresetتعداد لأنواع الإعدادات المُسبقة للقوائم
PageBackgroundTypePageBackgroundTypeتعداد لأنواع خلفيات الصفحات.
PageElementTypePageElementTypeتعداد لأنواع عناصر الصفحة
PageTypePageTypeتعداد لأنواع الصفحات.
ParagraphAlignmentParagraphAlignmentتعداد لأنواع محاذاة الفقرات
PlaceholderTypePlaceholderTypeتعداد لأنواع العناصر النائبة.
PredefinedLayoutPredefinedLayoutتعداد للتنسيقات المحدّدة مسبقًا.
SelectionTypeSelectionTypeتعداد لأنواع عمليات الاختيار
ShapeTypeShapeTypeتعداد لأنواع الأشكال
SheetsChartEmbedTypeSheetsChartEmbedTypeتعداد لأنواع تضمين الرسوم البيانية في "جداول بيانات Google".
SlideLinkingModeSlideLinkingModeتعداد للطرق التي يمكن من خلالها ربط "العروض التقديمية من Google"
SlidePositionSlidePositionتعداد لأنواع مواضع الشرائح
SpacingModeSpacingModeتعداد لأنواع أوضاع التباعد بين الخطوط
TextBaselineOffsetTextBaselineOffsetتعداد لأنواع إزاحة خط الأساس للنص.
TextDirectionTextDirectionتعداد لأنواع اتجاهات النص.
ThemeColorTypeThemeColorTypeتعداد لألوان المظهر
VideoSourceTypeVideoSourceTypeتعداد لأنواع مصادر الفيديو.

الطُرق

الطريقةنوع القيمة التي يتم إرجاعهاوصف قصير
create(name)Presentationينشئ Presentation جديدًا ويفتحه.
getActivePresentation()Presentation|nullتعرض هذه الدالة العرض التقديمي النشط حاليًا الذي يرتبط به النص البرمجي بالحاوية، أو null إذا لم يكن هناك عرض تقديمي نشط.
getUi()Uiتعرض هذه الطريقة مثيلاً لبيئة واجهة المستخدم الخاصة بالعرض التقديمي، ما يسمح للنص البرمجي بإضافة ميزات مثل القوائم ومربّعات الحوار والأشرطة الجانبية.
newAffineTransformBuilder()AffineTransformBuilderتعرض هذه الدالة AffineTransformBuilder جديدًا لإنشاء AffineTransform.
openById(id)Presentationيفتح Presentation بالمعرّف المحدّد.
openByUrl(url)Presentationيفتح هذا الإجراء Presentation باستخدام عنوان URL المحدّد.

مستندات تفصيلية

create(name)

ينشئ Presentation جديدًا ويفتحه.

المعلمات

الاسمالنوعالوصف
nameStringاسم العرض التقديمي الذي سيتم إنشاؤه

الإرجاع

Presentation: العرض التقديمي الذي يحمل الاسم المحدّد

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام نطاق واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/presentations

getActivePresentation()

تعرض هذه الدالة العرض التقديمي النشط حاليًا الذي يرتبط به النص البرمجي بالحاوية، أو null إذا لم يكن هناك عرض تقديمي نشط. للتفاعل مع عرض تقديمي لا يرتبط النص البرمجي بحاوية، استخدِم openById(id) بدلاً من ذلك. 

// Get the current presentation to which this script is bound.
const presentation = SlidesApp.getActivePresentation();
 إذا كان العرض التقديمي مفتوحًا، يتم عرض مثيل العرض التقديمي نفسه.

الإرجاع

Presentation|null

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام نطاق واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getUi()

تعرض هذه الطريقة مثيلاً لبيئة واجهة المستخدم الخاصة بالعرض التقديمي، ما يسمح للنص البرمجي بإضافة ميزات مثل القوائم ومربّعات الحوار والأشرطة الجانبية. لا يمكن للنص البرمجي التفاعل مع واجهة المستخدم إلا في حالة العرض التقديمي المفتوح الحالي، وفقط إذا كان النص البرمجي مرتبطًا بالعرض التقديمي. لمزيد من المعلومات، اطّلِع على أدلة القوائم ومربّعات الحوار والأشرطة الجانبية. 

// Add a custom menu to the active presentation, including a separator and a
// sub-menu.
function onOpen(e) {
  SlidesApp.getUi()
      .createMenu('My Menu')
      .addItem('My menu item', 'myFunction')
      .addSeparator()
      .addSubMenu(
          SlidesApp.getUi()
              .createMenu('My sub-menu')
              .addItem('One sub-menu item', 'mySecondFunction')
              .addItem('Another sub-menu item', 'myThirdFunction'),
          )
      .addToUi();
}

الإرجاع

Ui

newAffineTransformBuilder()

تعرض هذه الدالة AffineTransformBuilder جديدًا لإنشاء AffineTransform. يتم ضبط أداة الإنشاء مسبقًا باستخدام تحويل التشابه الخاص بالهوية.

الإرجاع

AffineTransformBuilder

openById(id)

يفتح Presentation بالمعرّف المحدّد. 

// Open a presentation by ID.
const presentation = SlidesApp.openById('docId');
 إذا كان العرض التقديمي مفتوحًا، يتم عرض مثيل العرض التقديمي نفسه.

المعلمات

الاسمالنوعالوصف
idString

الإرجاع

‫Presentation: العرض التقديمي الذي يحمل المعرّف المحدّد

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام نطاق واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/presentations

openByUrl(url)

يفتح هذا الإجراء Presentation باستخدام عنوان URL المحدّد. 

// Open a presentation by URL.
const presentation = SlidesApp.openByUrl(
    'https://docs.google.com/presentation/d/docId/edit',
);
 إذا كان العرض التقديمي مفتوحًا، يتم عرض مثيل العرض التقديمي نفسه.

المعلمات

الاسمالنوعالوصف
urlString

الإرجاع

Presentation: العرض التقديمي الذي يتضمّن عنوان URL المحدّد

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام نطاق واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/presentations