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()

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