قائمة مخصّصة في مثيل لواجهة مستخدم تطبيق 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(); }
الطُرق
الطريقة | نوع القيمة التي يتم عرضها | وصف قصير |
---|---|---|
add | Menu | تُضيف عنصرًا إلى القائمة. |
add | Menu | تضيف فاصلًا مرئيًا إلى القائمة. |
add | Menu | تُضيف قائمة فرعية إلى القائمة. |
add | void | تُدرج القائمة في مثيل واجهة مستخدِم المحرِّر. |
مستندات تفصيلية
add Item(caption, functionName)
تُضيف عنصرًا إلى القائمة. يجب أن يكون تصنيف عنصر القائمة بحالة أحرف الجملة (كتابة الحرف الأول من الكلمة فقط كبيرًا).
المعلمات
الاسم | النوع | الوصف |
---|---|---|
caption | String | تصنيف عنصر القائمة، مع كتابة الكلمة الأولى فقط بأحرف كبيرة |
function | String | اسم الدالة التي سيتمّ استدعاؤها عندما يختار المستخدِم العنصر. يمكنك
استخدام الدوال من المكتبات المضمّنة، مثل Library.libFunction1 . |
الإرجاع
add Sub Menu(menu)
add To Ui()
تُدرج القائمة في مثيل واجهة مستخدِم المحرِّر.