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)

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

المعلمات

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

الإرجاع

Menu — هذا الرمز Menu، لإنشاء سلسلة.


addSeparator()

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

الإرجاع

Menu — هذا الرمز Menu، لإنشاء سلسلة.


addSubMenu(menu)

تُضيف قائمة فرعية إلى القائمة.

المعلمات

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

الإرجاع

Menu — هذا الرمز Menu، لإنشاء سلسلة.


addToUi()

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