Class Browser

דפדפן

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

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

כדאי לעיין גם בפרטים הבאים

• ButtonSet

תכונות

נכס	תיאור	התיאור
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