Questa pagina è stata tradotta dall'API Cloud Translation.

Class Grid

Una griglia organizzata per visualizzare una raccolta di elementi della griglia.

var grid = CardService.newGrid()
    .setTitle("My Grid")
    .setNumColumns(2)
    .addItem(CardService.newGridItem()
        .setTitle("My item"));

Metodi

Metodo	Tipo restituito	Breve descrizione
`addItem(gridItem)`	`Grid`	Aggiunge un nuovo elemento alla griglia.
`setAuthorizationAction(action)`	`Grid`	Imposta un'azione di autorizzazione che apre un URL nel flusso di autorizzazione quando viene fatto clic sull'oggetto.
`setBorderStyle(borderStyle)`	`Grid`	Imposta lo stile del bordo applicato a ogni elemento della griglia.
`setComposeAction(action, composedEmailType)`	`Grid`	Imposta un'azione che scrive una bozza dell'email quando un utente fa clic sull'oggetto.
`setNumColumns(numColumns)`	`Grid`	Il numero di colonne da visualizzare nella griglia.
`setOnClickAction(action)`	`Grid`	Imposta un'azione da eseguire quando viene fatto clic sull'oggetto.
`setOnClickOpenLinkAction(action)`	`Grid`	Imposta un'azione che apre un URL in una scheda quando l'utente fa clic sull'oggetto.
`setOpenLink(openLink)`	`Grid`	Imposta un URL da aprire quando viene fatto clic sull'oggetto.
`setTitle(title)`	`Grid`	Imposta il testo del titolo della griglia.

Documentazione dettagliata

`addItem(gridItem)`

Aggiunge un nuovo elemento alla griglia.

Parametri

Nome	Tipo	Descrizione
`gridItem`	`GridItem`	L'elemento della griglia da aggiungere.

Andata e ritorno

Grid: 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

Grid: questo oggetto, per il concatenamento.

`setBorderStyle(borderStyle)`

Imposta lo stile del bordo applicato a ogni elemento della griglia. Il valore predefinito è NO_BORDER.

Parametri

Nome	Tipo	Descrizione
`borderStyle`	`BorderStyle`	Lo stile del bordo da applicare.

Andata e ritorno

Grid: 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

Grid: questo oggetto, per il concatenamento.

`setNumColumns(numColumns)`

Il numero di colonne da visualizzare nella griglia. Se mostrate nel riquadro laterale a destra, potete visualizzare da 1 a 3 colonne e il valore predefinito è 1. Se mostrata in una finestra di dialogo, puoi visualizzare da 2 a 6 colonne e il valore predefinito è 2.

Parametri

Nome	Tipo	Descrizione
`numColumns`	`Integer`	Il numero di colonne.

Andata e ritorno

Grid: 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

Grid: 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

Grid: 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

Grid: questo oggetto, per il concatenamento.

`setTitle(title)`

Imposta il testo del titolo della griglia. Il testo deve essere una semplice stringa senza formattazione.

Parametri

Nome	Tipo	Descrizione
`title`	`String`	Il testo del titolo.

Andata e ritorno

Grid: questo oggetto, per il concatenamento.