Class Browser

דפדפן

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

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

ראה גם

מאפיינים

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

Methods

שיטהסוג הערך המוחזרתיאור קצר
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)

תיפתח תיבת דו-שיח עם תיבת קלט טקסט בדפדפן של המשתמש.

שיטת 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 – הטקסט שהמשתמש הזין (או 'ביטול' עבור תיבת דו-שיח שבוטלה או נסגרה).

אישור

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

  • 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 – הטקסט שהמשתמש הזין (או 'ביטול' עבור תיבת דו-שיח שבוטלה או נסגרה).

אישור

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

  • 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 – הטקסט שהמשתמש הזין (או 'ביטול' עבור תיבת דו-שיח שבוטלה או נסגרה).

אישור

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

  • 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 — הטקסט באותיות קטנות של הלחצן שהמשתמש לוחץ עליו (או 'ביטול' לתיבת דו-שיח שנסגרה).

אישור

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

  • 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 — הטקסט באותיות קטנות של הלחצן שהמשתמש לוחץ עליו (או 'ביטול' לתיבת דו-שיח שנסגרה).

אישור

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

  • 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 — הטקסט באותיות קטנות של הלחצן שהמשתמש לוחץ עליו (או 'ביטול' לתיבת דו-שיח שנסגרה).

אישור

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

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