قائمة مخصَّصة في مثيل لواجهة المستخدم في تطبيق 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 . |
الإرجاع
addSubMenu(menu)
addToUi()
إدراج القائمة في مثيل واجهة مستخدم المحرّر