המחלקות האלה מספקות גישה לתיבות דו-שיח שספציפיות ל-Google Sheets.
השיטות בכיתה הזו זמינות לשימוש רק בהקשר של גיליון אלקטרוני של Google. במקום זאת, צריך להשתמש בתיבות דו-שיח של Google Workspace.
ראה גם
מאפיינים
| נכס | סוג | תיאור |
|---|---|---|
Buttons | Button |
Methods
| שיטה | סוג הערך שמוחזר | תיאור קצר |
|---|---|---|
input | String|null | מוצגת תיבת דו-שיח עם תיבת הזנת טקסט בדפדפן של המשתמש. |
input | String|null | מוצגת תיבת דו-שיח עם תיבת הזנת טקסט בדפדפן של המשתמש. |
input | String|null | מוצגת תיבת דו-שיח עם תיבת הזנת טקסט בדפדפן של המשתמש. |
msg | String|null | מוצגת תיבת דו-שיח עם ההודעה שצוינה וכפתור 'אישור' בדפדפן של המשתמש. |
msg | String|null | תיבת דו-שיח קופצת עם ההודעה שצוינה והלחצנים שצוינו בדפדפן של המשתמש. |
msg | String|null | תיבת דו-שיח קופצת עם הכותרת, ההודעה והלחצנים שצוינו בדפדפן של המשתמש. |
תיעוד מפורט
input Box(prompt)
מוצגת תיבת דו-שיח עם תיבת הזנת טקסט בדפדפן של המשתמש.
השיטה inputBox מעלה תיבת קלט בצד הלקוח שמציגה את ההנחיה הנתונה למשתמש. שימו לב שהפונקציה הזו גורמת להשעיה של הסקריפט בצד השרת. הוא מתחדש אוטומטית אחרי שהמשתמש סוגר את תיבת הדו-שיח, אבל חיבורי JDBC לא נשמרים במהלך ההשעיה.
// The code below sets the value of name to the name input by the user, or // 'cancel'. const name = Browser.inputBox('Enter your name');
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
prompt | String | הטקסט שיוצג בתיבת הדו-שיח. |
חזרה
String|null – הטקסט שהוזן על ידי המשתמש (או 'ביטול' אם תיבת הדו-שיח בוטלה או נסגרה).
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
input Box(prompt, buttons)
מוצגת תיבת דו-שיח עם תיבת הזנת טקסט בדפדפן של המשתמש.
השיטה inputBox מעלה תיבת קלט בצד הלקוח שמציגה את ההנחיה שצוינה למשתמש, ומציעה בחירה של כפתורים שיוצגו. שימו לב שהפונקציה הזו גורמת להשהיה של הסקריפט בצד השרת. הוא מתחדש אוטומטית אחרי שהמשתמש סוגר את תיבת הדו-שיח, אבל חיבורי JDBC לא נשמרים במהלך ההשעיה.
// The code below sets the value of name to the name input by the user, or // 'cancel'. const name = Browser.inputBox('Enter your name', Browser.Buttons.OK_CANCEL);
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
prompt | String | הטקסט שיוצג בתיבת הדו-שיח. |
buttons | Button | סוג הכפתור שמוגדר לשימוש. |
חזרה
String|null – הטקסט שהוזן על ידי המשתמש (או 'ביטול' אם תיבת הדו-שיח בוטלה או נסגרה).
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
input Box(title, prompt, buttons)
מוצגת תיבת דו-שיח עם תיבת הזנת טקסט בדפדפן של המשתמש.
השיטה inputBox מעלה תיבת קלט בצד הלקוח עם הכותרת שצוינה, שמציגה את ההנחיה שצוינה למשתמש ומציעה מבחר של לחצנים שיוצגו. שימו לב שהפונקציה הזו גורמת להשעיה של הסקריפט בצד השרת. הוא יתחדש אוטומטית אחרי שהמשתמש יסגור את תיבת הדו-שיח, אבל חיבורי JDBC לא יישמרו במהלך ההשעיה.
// The code below sets the value of name to the name input by the user, or // 'cancel'. const name = Browser.inputBox( 'ID Check', 'Enter your name', Browser.Buttons.OK_CANCEL, );
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
title | String | הכותרת של תיבת הדו-שיח. |
prompt | String | הטקסט שיוצג בתיבת הדו-שיח. |
buttons | Button | סוג הכפתור שמוגדר לשימוש. |
חזרה
String|null – הטקסט שהוזן על ידי המשתמש (או 'ביטול' אם תיבת הדו-שיח בוטלה או נסגרה).
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
msg Box(prompt)
מוצגת תיבת דו-שיח עם ההודעה שצוינה וכפתור 'אישור' בדפדפן של המשתמש.
השיטה msgBox מעלה תיבת הודעה בצד הלקוח שמציגה את ההודעה שצוינה למשתמש. שימו לב: השיטה הזו גורמת להשעיה של הסקריפט בצד השרת. הוא מתחדש אוטומטית אחרי שהמשתמש סוגר את תיבת הדו-שיח, אבל חיבורי JDBC לא נשמרים במהלך ההשעיה.
// The code below displays "hello world" in a dialog box with an OK button Browser.msgBox('hello world');
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
prompt | String | הטקסט שיוצג בתיבת הדו-שיח. |
חזרה
String|null — הטקסט באותיות קטנות של הכפתור שהמשתמש לחץ עליו (או cancel אם תיבת הדו-שיח נסגרה).
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
msg Box(prompt, buttons)
תיבת דו-שיח קופצת עם ההודעה שצוינה והלחצנים שצוינו בדפדפן של המשתמש.
השיטה msgBox מעלה תיבת הודעה בצד הלקוח שמציגה למשתמש את ההודעה שצוינה, ומציעה לבחור מבין הלחצנים שיוצגו. שימו לב שהשיטה הזו גורמת להשהיה של הסקריפט בצד השרת. הוא מתחדש אוטומטית אחרי שהמשתמש סוגר את תיבת הדו-שיח, אבל חיבורי JDBC לא נשמרים במהלך ההשעיה.
// The code below displays "hello world" in a dialog box with OK and Cancel // buttons. Browser.msgBox('hello world', Browser.Buttons.OK_CANCEL);
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
prompt | String | הטקסט שיוצג בתיבת הדו-שיח. |
buttons | Button | סוג הכפתור שמוגדר לשימוש. |
חזרה
String|null — הטקסט באותיות קטנות של הכפתור שהמשתמש לחץ עליו (או cancel אם תיבת הדו-שיח נסגרה).
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
msg Box(title, prompt, buttons)
תיבת דו-שיח קופצת עם הכותרת, ההודעה והלחצנים שצוינו בדפדפן של המשתמש.
השיטה msgBox מעלה תיבת הודעה בצד הלקוח עם הכותרת שצוינה, שמציגה את ההודעה שצוינה למשתמש ומציעה מבחר של לחצנים שיוצגו. חשוב לזכור שהשיטה הזו גורמת להשהיה של הסקריפט בצד השרת. הוא יתחדש אוטומטית אחרי שהמשתמש יסגור את תיבת הדו-שיח, אבל חיבורי JDBC לא יישמרו במהלך ההשעיה.
// The code below displays "hello world" in a dialog box with a custom title and // Yes and No buttons Browser.msgBox('Greetings', 'hello world', Browser.Buttons.YES_NO);
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
title | String | השם של תיבת הדו-שיח. |
prompt | String | הטקסט שיוצג בתיבת הדו-שיח. |
buttons | Button | סוג הכפתור שמוגדר לשימוש. |
חזרה
String|null — הטקסט באותיות קטנות של הכפתור שהמשתמש לחץ עליו (או cancel אם תיבת הדו-שיח נסגרה).
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets