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