Class SlidesApp

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');

الخصائص

الموقع	النوع	الوصف
AlignmentPosition	AlignmentPosition	تعداد لأنواع مواضع المحاذاة.
ArrowStyle	ArrowStyle	تعداد لأنماط الأسهم المختلفة التي يمكن أن يحتوي عليها Line.
AutoTextType	AutoTextType	تعداد لأنواع النص التلقائي.
AutofitType	AutofitType	تعداد لأنواع الملء التلقائي.
CellMergeState	CellMergeState	تعداد لحالات الدمج المختلفة لخلية جدول.
ColorType	ColorType	تعداد لأنواع الألوان.
ContentAlignment	ContentAlignment	تعداد للقيم المستخدَمة لتحديد محاذاة المحتوى
DashStyle	DashStyle	تعداد لأنماط الشرطات المختلفة التي يمكن أن يحتوي عليها Line.
FillType	FillType	تعداد لأنواع الملء.
LineCategory	LineCategory	تعداد لفئات Line.
LineFillType	LineFillType	تعداد لأنواع LineFill.
LineType	LineType	تعداد لأنواع Line.
LinkType	LinkType	تعداد لأنواع الروابط
ListPreset	ListPreset	تعداد لأنواع الإعدادات المُسبقة للقوائم
PageBackgroundType	PageBackgroundType	تعداد لأنواع خلفيات الصفحات.
PageElementType	PageElementType	تعداد لأنواع عناصر الصفحة
PageType	PageType	تعداد لأنواع الصفحات.
ParagraphAlignment	ParagraphAlignment	تعداد لأنواع محاذاة الفقرات
PlaceholderType	PlaceholderType	تعداد لأنواع العناصر النائبة
PredefinedLayout	PredefinedLayout	تعداد للتنسيقات المحدّدة مسبقًا.
SelectionType	SelectionType	تعداد لأنواع عمليات الاختيار
ShapeType	ShapeType	تعداد لأنواع الأشكال
SheetsChartEmbedType	SheetsChartEmbedType	تعداد لأنواع تضمين الرسوم البيانية في "جداول بيانات Google".
SlideLinkingMode	SlideLinkingMode	تعداد لطرق ربط "العروض التقديمية من Google".
SlidePosition	SlidePosition	تعداد لأنواع مواضع الشرائح.
SpacingMode	SpacingMode	تعداد لأنواع أوضاع التباعد بين الخطوط
TextBaselineOffset	TextBaselineOffset	تعداد لأنواع إزاحة خط الأساس للنص.
TextDirection	TextDirection	تعداد لأنواع اتجاهات النص.
ThemeColorType	ThemeColorType	تعداد لألوان المظهر.
VideoSourceType	VideoSourceType	تعداد لأنواع مصادر الفيديو.

الطُرق

الطريقة	نوع القيمة التي تم إرجاعها	وصف قصير
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 جديدًا ويفتحه.

المَعلمات

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

الإرجاع

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');

إذا كان العرض التقديمي مفتوحًا، يتم عرض مثيل العرض التقديمي نفسه.

المَعلمات

الاسم	النوع	الوصف
id	String	رقم تعريف العرض التقديمي المطلوب فتحه.

الإرجاع

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',
);

إذا كان العرض التقديمي مفتوحًا، يتم عرض مثيل العرض التقديمي نفسه.

المَعلمات

الاسم	النوع	الوصف
url	String	عنوان URL الخاص بالعرض التقديمي الذي تريد فتحه

الإرجاع

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

التفويض

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

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