Questa pagina è stata tradotta dall'API Cloud Translation.

Class TextButton

Un TextButton con un'etichetta di testo. Puoi impostare il colore di sfondo e disattivare il pulsante quando necessario.

var textButton = CardService.newTextButton()
    .setText("Open Link")
    .setOpenLink(CardService.newOpenLink()
        .setUrl("https://www.google.com"));

Metodi

Metodo	Tipo restituito	Breve descrizione
`setAltText(altText)`	`TextButton`	Consente di impostare il testo alternativo del pulsante per l'accessibilità.
`setAuthorizationAction(action)`	`TextButton`	Imposta un'azione di autorizzazione che apre un URL nel flusso di autorizzazione quando viene fatto clic sull'oggetto.
`setBackgroundColor(backgroundColor)`	`TextButton`	Imposta il colore di sfondo per il pulsante `TextButtonStyle.FILLED`.
`setComposeAction(action, composedEmailType)`	`TextButton`	Imposta un'azione che scrive una bozza dell'email quando un utente fa clic sull'oggetto.
`setDisabled(disabled)`	`TextButton`	Consente di stabilire se il pulsante deve essere disattivato.
`setOnClickAction(action)`	`TextButton`	Imposta un'azione da eseguire quando viene fatto clic sull'oggetto.
`setOnClickOpenLinkAction(action)`	`TextButton`	Imposta un'azione che apre un URL in una scheda quando l'utente fa clic sull'oggetto.
`setOpenLink(openLink)`	`TextButton`	Imposta un URL da aprire quando viene fatto clic sull'oggetto.
`setText(text)`	`TextButton`	Consente di impostare il testo da visualizzare sul pulsante.
`setTextButtonStyle(textButtonStyle)`	`TextButton`	Imposta lo stile del pulsante.

Documentazione dettagliata

`setAltText(altText)`

Consente di impostare il testo alternativo del pulsante per l'accessibilità. Se il criterio non viene configurato, viene utilizzato per impostazione predefinita il testo visualizzato sul pulsante.

Parametri

Nome	Tipo	Descrizione
`altText`	`String`	Il testo alternativo da assegnare a questo pulsante.

Andata e ritorno

TextButton: questo oggetto, per il concatenamento.

`setAuthorizationAction(action)`

Imposta un'azione di autorizzazione che apre un URL nel flusso di autorizzazione quando viene fatto clic sull'oggetto. L'URL viene aperto in una nuova finestra. Quando l'utente termina il flusso dell'autorizzazione e torna all'applicazione, il componente aggiuntivo viene ricaricato.

Un oggetto UI può avere solo setOpenLink(openLink), setOnClickAction(action), setOnClickOpenLinkAction(action), setAuthorizationAction(action) o setComposeAction(action, composedEmailType) impostati.

// ...

var action = CardService.newAuthorizationAction().setAuthorizationUrl('url');
CardService.newTextButton().setText('Authorize').setAuthorizationAction(action);

Parametri

Nome	Tipo	Descrizione
`action`	`AuthorizationAction`	Oggetto che specifica l'azione di autorizzazione da eseguire quando viene fatto clic su questo elemento.

Andata e ritorno

TextButton: questo oggetto, per il concatenamento.

`setBackgroundColor(backgroundColor)`

Imposta il colore di sfondo per il pulsante TextButtonStyle.FILLED. Se non è impostato per un pulsante TextButtonStyle.FILLED, il pulsante utilizza il colore secondario definito nel manifest aggiuntivo. Questo metodo è autonomo per i pulsanti TextButtonStyle.TEXT.

Parametri

Nome	Tipo	Descrizione
`backgroundColor`	`String`	Il colore in formato #rgb.

Andata e ritorno

TextButton: questo oggetto, per il concatenamento.

`setComposeAction(action, composedEmailType)`

Imposta un'azione che scrive una bozza dell'email quando un utente fa clic sull'oggetto. Un oggetto UI può avere solo setOpenLink(openLink), setOnClickAction(action), setOnClickOpenLinkAction(action), setAuthorizationAction(action) o setComposeAction(action, composedEmailType) impostati.

Il parametro Action deve specificare una funzione di callback che restituisce un oggetto ComposeActionResponse configurato utilizzando ComposeActionResponseBuilder.setGmailDraft(draft).

Nota: questo metodo non imposta un'azione di scrittura che venga utilizzata per estendere l'interfaccia utente di scrittura. Questo metodo collega invece questo elemento UI a un Action che compone bozze di messaggi in Apps Script che vengono aperti in Gmail al termine dell'azione.

// ...

var action = CardService.newAction().setFunctionName('composeEmailCallback');
CardService.newTextButton()
    .setText('Compose Email')
    .setComposeAction(action, CardService.ComposedEmailType.REPLY_AS_DRAFT);

// ...

function composeEmailCallback() {
  var thread = GmailApp.getThreadById(e.threadId);
  var draft = thread.createDraftReply('This is a reply');
  return CardService.newComposeActionResponseBuilder()
      .setGmailDraft(draft)
      .build();
}

Parametri

Nome	Tipo	Descrizione
`action`	`Action`	L'oggetto che specifica l'azione di scrittura da eseguire quando viene fatto clic su questo elemento.
`composedEmailType`	`ComposedEmailType`	Un valore di enumerazione che specifica se la bozza composta è una bozza autonoma o una bozza di risposta.

Andata e ritorno

TextButton: questo oggetto, per il concatenamento.

`setDisabled(disabled)`

Consente di stabilire se il pulsante deve essere disattivato. Un pulsante disattivato non è selezionabile e non può essere selezionato.

Parametri

Nome	Tipo	Descrizione
`disabled`	`Boolean`	Lo stato disattivato.

Andata e ritorno

TextButton: questo oggetto, per il concatenamento.

`setOnClickAction(action)`

Imposta un'azione da eseguire quando viene fatto clic sull'oggetto. Un oggetto UI può avere solo uno dei seguenti valori: setOpenLink(openLink), setOnClickAction(action), setOnClickOpenLinkAction(action), setAuthorizationAction(action) o setComposeAction(action, composedEmailType).

Il parametro Action deve specificare una funzione di callback che restituisce un oggetto ActionResponse.

// ...

var action = CardService.newAction().setFunctionName('notificationCallback');
CardService.newTextButton().setText('Create notification').setOnClickAction(action);

// ...

function notificationCallback() {
  return CardService.newActionResponseBuilder()
      .setNotification(CardService.newNotification()
          .setText("Some info to display to user"))
      .build();
}

Parametri

Nome	Tipo	Descrizione
`action`	`Action`	L'azione da eseguire quando viene fatto clic su questo elemento.

Andata e ritorno

TextButton: questo oggetto, per il concatenamento.

`setOnClickOpenLinkAction(action)`

Imposta un'azione che apre un URL in una scheda quando l'utente fa clic sull'oggetto. Utilizza questa funzione quando devi creare l'URL o devi eseguire altre azioni aggiuntive per creare l'oggetto OpenLink. Un oggetto UI può avere solo setOpenLink(openLink), setOnClickAction(action), setOnClickOpenLinkAction(action), setAuthorizationAction(action) o setComposeAction(action, composedEmailType) impostati.

Il parametro Action deve specificare una funzione di callback che restituisce un oggetto ActionResponse configurato utilizzando ActionResponseBuilder.setOpenLink(openLink).

// ...

var action = CardService.newAction().setFunctionName('openLinkCallback');
CardService.newTextButton().setText('Open Link').setOnClickOpenLinkAction(action);

// ...

function openLinkCallback() {
  return CardService.newActionResponseBuilder()
      .setOpenLink(CardService.newOpenLink()
          .setUrl('https://www.google.com'))
      .build();
}

Parametri

Nome	Tipo	Descrizione
`action`	`Action`	L'oggetto che specifica l'azione di link aperto da intraprendere quando viene fatto clic su questo elemento.

Andata e ritorno

TextButton: questo oggetto, per il concatenamento.

`setOpenLink(openLink)`

Imposta un URL da aprire quando viene fatto clic sull'oggetto. Utilizza questa funzione quando l'URL è già noto e deve essere aperto. Un oggetto UI può avere solo setOpenLink(openLink), setOnClickAction(action), setOnClickOpenLinkAction(action), setAuthorizationAction(action) o setComposeAction(action, composedEmailType) impostati.

Parametri

Nome	Tipo	Descrizione
`openLink`	`OpenLink`	Un oggetto `OpenLink` che descrive l'URL da aprire.

Andata e ritorno

TextButton: questo oggetto, per il concatenamento.

`setText(text)`

Consente di impostare il testo da visualizzare sul pulsante.

Parametri

Nome	Tipo	Descrizione
`text`	`String`	Il testo che appare sul pulsante.

Andata e ritorno

TextButton: questo oggetto, per il concatenamento.

`setTextButtonStyle(textButtonStyle)`

Imposta lo stile del pulsante. Se non viene configurato, il valore predefinito è il pulsante TextButtonStyle.TEXT.

Parametri

Nome	Tipo	Descrizione
`textButtonStyle`	`TextButtonStyle`	Lo stile del pulsante.

Andata e ritorno

TextButton: questo oggetto, per il concatenamento.