Class Browser

דפדפן

המחלקות האלה מספקות גישה לתיבות דו-שיח שספציפיות ל-Google Sheets.

השיטות בכיתה הזו זמינות לשימוש רק בהקשר של גיליון אלקטרוני של Google. במקום זאת, צריך להשתמש בתיבות דו-שיח של Google Workspace.

ראה גם

מאפיינים

נכססוגתיאור
ButtonsButtonSet

Methods

שיטהסוג הערך שמוחזרתיאור קצר
inputBox(prompt)String|nullמוצגת תיבת דו-שיח עם תיבת קלט בדפדפן של המשתמש.
inputBox(prompt, buttons)String|nullמוצגת תיבת דו-שיח עם תיבת קלט בדפדפן של המשתמש.
inputBox(title, prompt, buttons)String|nullמוצגת תיבת דו-שיח עם תיבת קלט בדפדפן של המשתמש.
msgBox(prompt)String|nullמוצגת תיבת דו-שיח עם ההודעה שצוינה ולחצן 'אישור' בדפדפן של המשתמש.
msgBox(prompt, buttons)String|nullתיבת דו-שיח קופצת עם ההודעה שצוינה והלחצנים שצוינו בדפדפן של המשתמש.
msgBox(title, prompt, buttons)String|nullתיבת דו-שיח קופצת עם הכותרת, ההודעה והלחצנים שצוינו בדפדפן של המשתמש.

תיעוד מפורט

inputBox(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');
השיטה הזו לא מומלצת. במקום זאת, צריך להשתמש בהנחיה בממשק המשתמש.

פרמטרים

שםסוגתיאור
promptStringהטקסט שיוצג בתיבת הדו-שיח.

חזרה

String|null – הטקסט שהוזן על ידי המשתמש (או 'ביטול' אם תיבת הדו-שיח בוטלה או נסגרה).

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

inputBox(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);
השיטה הזו לא מומלצת. במקום זאת, צריך להשתמש בהנחיה בממשק המשתמש.

פרמטרים

שםסוגתיאור
promptStringהטקסט שיוצג בתיבת הדו-שיח.
buttonsButtonSetסוג הכפתור שמוגדר לשימוש.

חזרה

String|null – הטקסט שהוזן על ידי המשתמש (או 'ביטול' אם תיבת הדו-שיח בוטלה או נסגרה).

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

inputBox(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,
);
השיטה הזו לא מומלצת. במקום זאת, צריך להשתמש בהנחיה בממשק המשתמש.

פרמטרים

שםסוגתיאור
titleStringהכותרת של תיבת הדו-שיח.
promptStringהטקסט שיוצג בתיבת הדו-שיח.
buttonsButtonSetסוג הכפתור שמוגדר לשימוש.

חזרה

String|null – הטקסט שהוזן על ידי המשתמש (או 'ביטול' אם תיבת הדו-שיח בוטלה או נסגרה).

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:

  • 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');
השיטה הזו לא מומלצת. במקום זאת, צריך להשתמש בתיבת דו-שיח של התראה בממשק המשתמש.

פרמטרים

שםסוגתיאור
promptStringהטקסט שיוצג בתיבת הדו-שיח.

חזרה

String|null — הטקסט באותיות קטנות של הכפתור שהמשתמש לחץ עליו (או cancel אם תיבת הדו-שיח נסגרה).

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:

  • 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);
השיטה הזו לא מומלצת. במקום זאת, צריך להשתמש בתיבת דו-שיח של התראה בממשק המשתמש.

פרמטרים

שםסוגתיאור
promptStringהטקסט שיוצג בתיבת הדו-שיח.
buttonsButtonSetסוג הכפתור שמוגדר לשימוש.

חזרה

String|null — הטקסט באותיות קטנות של הכפתור שהמשתמש לחץ עליו (או cancel אם תיבת הדו-שיח נסגרה).

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:

  • 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);
השיטה הזו לא מומלצת. במקום זאת, צריך להשתמש בתיבת דו-שיח של התראה בממשק המשתמש.

פרמטרים

שםסוגתיאור
titleStringהכותרת של תיבת הדו-שיח.
promptStringהטקסט שיוצג בתיבת הדו-שיח.
buttonsButtonSetסוג הכפתור שמוגדר לשימוש.

חזרה

String|null — הטקסט באותיות קטנות של הכפתור שהמשתמש לחץ עליו (או cancel אם תיבת הדו-שיח נסגרה).

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets