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

أماكن إقامة

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

التفويض

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

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

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

المعلَمات

الاسم	النوع	الوصف
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

الإرجاع

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

التفويض

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

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