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