Class Menu

القائمة

قائمة مخصّصة في إحدى حالات واجهة المستخدم لأحد تطبيقات Google، ولا يمكن للنص البرمجي التفاعل إلا مع واجهة المستخدم للحالة الحالية لمستند أو نموذج مفتوح، وفقط إذا كان النص البرمجي مرتبطًا بالحاوية بالمستند أو النموذج. لمزيد من المعلومات، يُرجى الاطّلاع على دليل القوائم.

// Add a custom menu to the active spreadsheet, including a separator and a
// sub-menu.
function onOpen(e) {
  SpreadsheetApp.getUi()
      .createMenu('My Menu')
      .addItem('My Menu Item', 'myFunction')
      .addSeparator()
      .addSubMenu(
          SpreadsheetApp.getUi()
              .createMenu('My Submenu')
              .addItem('One Submenu Item', 'mySecondFunction')
              .addItem('Another Submenu Item', 'myThirdFunction'),
          )
      .addToUi();
}

الطُرق

الطريقة	نوع القيمة التي تم إرجاعها	وصف قصير
addItem(caption, functionName)	Menu	تضيف هذه السمة عنصرًا إلى القائمة.
addSeparator()	Menu	تضيف هذه السمة فاصلًا مرئيًا إلى القائمة.
addSubMenu(menu)	Menu	تضيف هذه السمة قائمة فرعية إلى القائمة.
addToUi()	void	يُدرِج القائمة في مثيل واجهة مستخدم المحرِّر.

مستندات تفصيلية

addItem(caption, functionName)

تضيف هذه السمة عنصرًا إلى القائمة. يجب أن يكون تصنيف عنصر القائمة في حالة أحرف الجملة (أي أن يكون الحرف الأول من الكلمة الأولى فقط كبيرًا).

المعلمات

الاسم	النوع	الوصف
caption	String	تصنيف عنصر القائمة، مع كتابة الحرف الأول من الكلمة الأولى فقط بأحرف كبيرة
functionName	String	اسم الدالة التي سيتم استدعاؤها عندما يختار المستخدم العنصر. يمكنك استخدام دوال من المكتبات المضمّنة، مثل Library.libFunction1.

الإرجاع

‫Menu: هذا Menu، للسلاسل.

---

addSeparator()

تضيف هذه السمة فاصلًا مرئيًا إلى القائمة.

الإرجاع

‫Menu: هذا Menu، للسلاسل.

---

addSubMenu(menu)

تضيف هذه السمة قائمة فرعية إلى القائمة.

المعلمات

الاسم	النوع	الوصف
menu	Menu	القائمة الفرعية، التي تم إنشاؤها مثل قائمة المستوى الأعلى

الإرجاع

‫Menu: هذا Menu، للسلاسل.

---

addToUi()

يُدرِج القائمة في مثيل واجهة مستخدم المحرِّر.