Class SlidesApp

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

لإنشاء 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 في حال عدم توفّر عرضٍ لتقديميٍ نشط.
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

التفويض

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

  • 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