Class SectionHeaderItem

SectionHeaderItem

يشير ذلك المصطلح إلى عنصر تصميم يشير إلى بداية القسم بشكل مرئي. يمكن الوصول إلى العناصر أو إنشاؤها من Form. 

// Open a form by ID and add a new section header.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var item = form.addSectionHeaderItem();
item.setTitle('Title of new section');

الطُرق

الطريقةنوع الإرجاعوصف قصير
duplicate()SectionHeaderItemإنشاء نسخة من هذا العنصر وإلحاقها بنهاية النموذج
getHelpText()Stringتحصل على نص المساعدة الخاص بالعنصر (يُسمّى أحيانًا نص الوصف لعناصر التنسيق مثل ImageItems وPageBreakItems وSectionHeaderItems).
getId()Integerالحصول على المعرّف الفريد للعنصر
getIndex()Integerالحصول على فهرس العنصر بين جميع العناصر في النموذج.
getTitle()Stringيحصل على عنوان العنصر (يُسمى أحيانًا نص العنوان، في حالة استخدام SectionHeaderItem).
getType()ItemTypeتعرض هذه السمة نوع العنصر، ويتم تمثيله على أنّه ItemType.
setHelpText(text)SectionHeaderItemتحدِّد هذه السياسة نص المساعدة للعنصر (يُسمّى أحيانًا نص الوصف لعناصر التنسيق مثل ImageItems وPageBreakItems وSectionHeaderItems).
setTitle(title)SectionHeaderItemتضبط عنوان العنصر (يُسمّى أحيانًا نص العنوان، في حال استخدام SectionHeaderItem).

الوثائق التفصيلية

duplicate()

إنشاء نسخة من هذا العنصر وإلحاقها بنهاية النموذج

الإرجاع

SectionHeaderItem — نسخة طبق الأصل من SectionHeaderItem، للسلسلة

التفويض

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

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

getHelpText()

تحصل على نص المساعدة الخاص بالعنصر (يُسمّى أحيانًا نص الوصف لعناصر التنسيق مثل ImageItems وPageBreakItems وSectionHeaderItems).

الإرجاع

String - نص مساعدة العنصر أو نص الوصف

التفويض

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

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

getId()

الحصول على المعرّف الفريد للعنصر

الإرجاع

Integer - معرّف العنصر

التفويض

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

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

getIndex()

الحصول على فهرس العنصر بين جميع العناصر في النموذج.

الإرجاع

Integer — فهرس العنصر

التفويض

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

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

getTitle()

يحصل على عنوان العنصر (يُسمى أحيانًا نص العنوان، في حالة استخدام SectionHeaderItem).

الإرجاع

String - عنوان العنصر أو نص رأسه

التفويض

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

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

getType()

تعرض هذه السمة نوع العنصر، ويتم تمثيله على أنّه ItemType.

الإرجاع

ItemType — نوع العنصر

التفويض

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

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

setHelpText(text)

تحدِّد هذه السياسة نص المساعدة للعنصر (يُسمّى أحيانًا نص الوصف لعناصر التنسيق مثل ImageItems وPageBreakItems وSectionHeaderItems).

المعلمات

الاسمالنوعالوصف
textStringنص المساعدة الجديد

الإرجاع

SectionHeaderItem — SectionHeaderItem هذا، للسلسلة

التفويض

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

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

setTitle(title)

تضبط عنوان العنصر (يُسمّى أحيانًا نص العنوان، في حال استخدام SectionHeaderItem).

المعلمات

الاسمالنوعالوصف
titleStringالعنوان أو نص العنوان الجديد

الإرجاع

SectionHeaderItem — SectionHeaderItem هذا، للسلسلة

التفويض

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

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