Class Browser

דפדפן

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

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

ראה גם

• ButtonSet

מאפיינים

נכס	סוג	תיאור
Buttons	ButtonSet

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');

השיטה הזו לא מומלצת. במקום זאת, צריך להשתמש בהנחיה בממשק המשתמש.

פרמטרים

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

חזרה

‫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);

השיטה הזו לא מומלצת. במקום זאת, צריך להשתמש בהנחיה בממשק המשתמש.

פרמטרים

שם	סוג	תיאור
prompt	String	הטקסט שיוצג בתיבת הדו-שיח.
buttons	ButtonSet	סוג הכפתור שמוגדר לשימוש.

חזרה

‫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,
);

השיטה הזו לא מומלצת. במקום זאת, צריך להשתמש בהנחיה בממשק המשתמש.

פרמטרים

שם	סוג	תיאור
title	String	הכותרת של תיבת הדו-שיח.
prompt	String	הטקסט שיוצג בתיבת הדו-שיח.
buttons	ButtonSet	סוג הכפתור שמוגדר לשימוש.

חזרה

‫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');

השיטה הזו לא מומלצת. במקום זאת, צריך להשתמש בתיבת דו-שיח של התראה בממשק המשתמש.

פרמטרים

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

חזרה

‫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);

השיטה הזו לא מומלצת. במקום זאת, צריך להשתמש בתיבת דו-שיח של התראה בממשק המשתמש.

פרמטרים

שם	סוג	תיאור
prompt	String	הטקסט שיוצג בתיבת הדו-שיח.
buttons	ButtonSet	סוג הכפתור שמוגדר לשימוש.

חזרה

‫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);

השיטה הזו לא מומלצת. במקום זאת, צריך להשתמש בתיבת דו-שיח של התראה בממשק המשתמש.

פרמטרים

שם	סוג	תיאור
title	String	הכותרת של תיבת הדו-שיח.
prompt	String	הטקסט שיוצג בתיבת הדו-שיח.
buttons	ButtonSet	סוג הכפתור שמוגדר לשימוש.

חזרה

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

אישור

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

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