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: 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عنوان URL الخاص بالعرض التقديمي الذي تريد فتحه

الإرجاع

استبدِل Presentation بالعرض التقديمي الذي يتضمّن عنوان URL المحدّد.

التفويض

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

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