قائمة مخصّصة في مثيل واجهة المستخدم لأحد تطبيقات 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)
إضافة عنصر إلى القائمة. يجب أن تكون تسمية عنصر القائمة في حالة الجملة (فقط الكلمة الأولى بأحرف كبيرة).
المَعلمات
| الاسم | Type | الوصف |
|---|---|---|
caption | String | تسمية عنصر القائمة، مع كتابة الكلمة الأولى فقط بأحرف كبيرة. |
functionName | String | اسم الدالة التي سيتم استدعاؤها عندما يختار المستخدم العنصر. ويمكنك
استخدام دوال من المكتبات المضمّنة، مثل Library.libFunction1. |
استرجاع الكرة
addSubMenu(menu)
addToUi()
يدرج هذا العنصر القائمة في النسخة الافتراضية من واجهة مستخدم المحرِّر.