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

Class Switch

רכיב בממשק המשתמש שתומך בהפעלה או בהשבתה. אפשר להשתמש באפשרות הזו רק בתוך הווידג'ט DecoratedText.

ההגדרה זמינה לתוספים ל-Google Workspace ולאפליקציות של Google Chat.

var switchDecoratedText  = CardService.newDecoratedText()
  .setTopLabel("Switch decorated text widget label")
  .setText("This is a decorated text widget with a switch on the right")
  .setWrapText(true)
  .setSwitchControl(CardService.newSwitch()
      .setFieldName("form_input_switch_key")
      .setValue("form_input_switch_value")
      .setOnChangeAction(CardService.newAction()
          .setFunctionName("handleSwitchChange")));

שיטות

שיטה	סוג הערך המוחזר	תיאור קצר
`setControlType(controlType)`	`Switch`	מגדיר את סוג אמצעי הבקרה של המתג.
`setFieldName(fieldName)`	`Switch`	מגדיר את המפתח שמזהה את המתג הזה באובייקט האירוע שנוצר כאשר אינטראקציה עם ממשק המשתמש.
`setOnChangeAction(action)`	`Switch`	הגדרת הפעולה לביצוע כשהמתג במצב מופעל.
`setSelected(selected)`	`Switch`	המדיניות קובעת אם המתג יתחיל להתחיל כפי שנבחר או לא נבחר.
`setValue(value)`	`Switch`	הגדרת הערך שנשלח כקלט הטופס כשהמתג הזה מופעל.

מסמכי תיעוד מפורטים

`setControlType(controlType)`

מגדיר את סוג אמצעי הבקרה של המתג. ברירת המחדל היא SWITCH.

פרמטרים

שם	סוג	תיאור
`controlType`	`SwitchControlType`	סוג אמצעי הבקרה של המתג.

חזרה

Switch – האובייקט הזה, לשרשור.

`setFieldName(fieldName)`

מגדיר את המפתח שמזהה את המתג הזה באובייקט האירוע שנוצר כאשר אינטראקציה עם ממשק המשתמש. לא גלוי למשתמש. חובה.

להבדיל משדות אחרים בטופס, שם השדה הזה לא חייב להיות ייחודי. הערכים שהוזנו בטופס עבור מתגים שמשתמשים באותו שם שדה, מוחזרים כמערך. המערך מורכב עבור כל המתגים המופעלים עם שם השדה הזה.

פרמטרים

שם	סוג	תיאור
`fieldName`	`String`	המפתח שמשמש לזיהוי המתג הזה.

חזרה

Switch – האובייקט הזה, לשרשור.

`setOnChangeAction(action)`

הגדרת הפעולה לביצוע כשהמתג במצב מופעל.

פרמטרים

שם	סוג	תיאור
`action`	`Action`	הפעולה לביצוע כשהמתג במצב מופעל.

חזרה

Switch – האובייקט הזה, לשרשור.

`setSelected(selected)`

המדיניות קובעת אם המתג יתחיל להתחיל כפי שנבחר או לא נבחר.

פרמטרים

שם	סוג	תיאור
`selected`	`Boolean`	הגדרה של מצב המתג ההתחלתי.

חזרה

Switch – האובייקט הזה, לשרשור.

`setValue(value)`

הגדרת הערך שנשלח כקלט הטופס כשהמתג הזה מופעל.

פרמטרים

שם	סוג	תיאור
`value`	`String`	הערך שמשויך לשם כשהמתג במצב מופעל. כשהערך נשלח אל והוא תמיד מיוצג כמחרוזת.

חזרה

Switch – האובייקט הזה, לשרשור.