דף זה תורגם על ידי Cloud Translation API.

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)`

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

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

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

שיטת קלט תיבת הקלט מעלה תיבת קלט בצד הלקוח שמציגה את ההנחיה הנתונה משתמש ומציע מבחר של לחצנים להצגה. חשוב לשים לב שהפונקציה הזו גורמת סקריפט בצד השרת שיש להשעות. ההעלאה ממשיכה באופן אוטומטי לאחר שהמשתמש מוחק את תיבת הדו-שיח, אבל חיבורי 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)`

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

שיטת קלט התיבה מעלה תיבה בצד הלקוח עם הכותרת הנתונה, שמציגה את נתונה להנחיה למשתמש, ומציעה בחירה של לחצנים להצגה. לתשומת ליבכם: גורמת להשעיית הסקריפט בצד השרת. ההתראה תמשיך באופן אוטומטי אחרי שהמשתמש פותח את תיבת הדו-שיח, אבל חיבורי 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