Class Slicer

Controllo filtro

Rappresenta un controllo filtro, che viene utilizzato per filtrare intervalli, grafici e tabelle pivot in modo non collaborativo. Questa classe contiene metodi per accedere ai controlli filtro esistenti e modificarli. Per creare un nuovo controllo filtro, utilizza Sheet.insertSlicer(range, anchorRowPos, anchorColPos).

Metodi

MetodoTipo restituitoBreve descrizione
getBackgroundColorObject()ColorRestituisce lo sfondo Color del controllo filtro.
getColumnPosition()IntegerRestituisce la posizione della colonna (relativa all'intervallo di dati del controllo filtro) su cui viene applicato il filtro nel controllo filtro oppure null se la posizione della colonna non è impostata.
getContainerInfo()ContainerInfoRecupera le informazioni sulla posizione del controllo filtro nel foglio.
getFilterCriteria()FilterCriteriaRestituisce i criteri di filtro del controllo filtro oppure null se i criteri di filtro non sono impostati.
getRange()RangeRestituisce l'intervallo di dati a cui viene applicato il controllo filtro.
getTitle()StringRestituisce il titolo del controllo filtro.
getTitleHorizontalAlignment()StringRestituisce l'allineamento orizzontale del titolo.
getTitleTextStyle()TextStyleRestituisce lo stile di testo del titolo del controllo filtro.
isAppliedToPivotTables()BooleanRestituisce se il controllo filtro specificato viene applicato alle tabelle pivot.
remove()voidElimina il controllo filtro.
setApplyToPivotTables(applyToPivotTables)SlicerConsente di impostare se il controllo filtro specificato deve essere applicato alle tabelle pivot nel foglio di lavoro.
setBackgroundColor(color)SlicerImposta il colore di sfondo del controllo filtro.
setBackgroundColorObject(color)SlicerImposta lo sfondo Color del controllo filtro.
setColumnFilterCriteria(columnPosition, filterCriteria)SlicerConsente di impostare l'indice della colonna e i criteri di filtro del controllo filtro.
setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)SlicerImposta la posizione in cui viene visualizzato il controllo filtro sul foglio.
setRange(rangeApi)SlicerImposta l'intervallo di dati a cui viene applicato il controllo filtro.
setTitle(title)SlicerImposta il titolo del controllo filtro.
setTitleHorizontalAlignment(horizontalAlignment)SlicerConsente di impostare l'allineamento orizzontale del titolo nel controllo filtro.
setTitleTextStyle(textStyle)SlicerConsente di impostare lo stile di testo del controllo filtro.

Documentazione dettagliata

getBackgroundColorObject()

Restituisce lo sfondo Color del controllo filtro.

Ritorni

Color: il colore di sfondo del controllo filtro. Restituisce null se non è impostato alcun colore.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getColumnPosition()

Restituisce la posizione della colonna (relativa all'intervallo di dati del controllo filtro) su cui viene applicato il filtro nel controllo filtro oppure null se la posizione della colonna non è impostata. Dovrebbe essere la posizione indicizzata di 1 della colonna, simile al filtro.

Ritorni

Integer: la posizione della colonna del controllo filtro.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getContainerInfo()

Recupera le informazioni sulla posizione del controllo filtro nel foglio.

Ritorni

ContainerInfo: un oggetto contenente la posizione del contenitore del controllo filtro.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getFilterCriteria()

Restituisce i criteri di filtro del controllo filtro oppure null se i criteri di filtro non sono impostati.

Ritorni

FilterCriteria: i criteri di filtro di questo controllo filtro.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getRange()

Restituisce l'intervallo di dati a cui viene applicato il controllo filtro.

Ritorni

Range: l'intervallo del controllo filtro.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getTitle()

Restituisce il titolo del controllo filtro.

Ritorni

String: questo controllo filtro, per il concatenamento.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getTitleHorizontalAlignment()

Restituisce l'allineamento orizzontale del titolo.

Ritorni

String: allineamento orizzontale del titolo di questo controllo filtro.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getTitleTextStyle()

Restituisce lo stile di testo del titolo del controllo filtro.

Ritorni

TextStyle: lo stile di testo del titolo del controllo filtro.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

isAppliedToPivotTables()

Restituisce se il controllo filtro specificato viene applicato alle tabelle pivot.

Ritorni

Boolean: true se questo controllo filtro viene applicato alle tabelle pivot, altrimenti false.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

remove()

Elimina il controllo filtro.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setApplyToPivotTables(applyToPivotTables)

Consente di impostare se il controllo filtro specificato deve essere applicato alle tabelle pivot nel foglio di lavoro.

Parametri

NomeTipoDescrizione
applyToPivotTablesBooleanSpecifica se questo controllo filtro deve essere applicato alle tabelle pivot.

Ritorni

Slicer: questo controllo filtro, per il concatenamento.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setBackgroundColor(color)

Imposta il colore di sfondo del controllo filtro. Un valore null reimposta il colore di sfondo.

Parametri

NomeTipoDescrizione
colorStringIl nuovo colore di sfondo del controllo filtro nella notazione CSS (ad esempio "#ffffff").

Ritorni

Slicer: questo controllo filtro, per il concatenamento.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setBackgroundColorObject(color)

Imposta lo sfondo Color del controllo filtro. Un valore null reimposta il colore di sfondo.

Parametri

NomeTipoDescrizione
colorColorIl nuovo colore di sfondo di questo controllo filtro.

Ritorni

Slicer: questo controllo filtro, per il concatenamento.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setColumnFilterCriteria(columnPosition, filterCriteria)

Consente di impostare l'indice della colonna e i criteri di filtro del controllo filtro. Un valore null reimposta il filtro Controllo filtro.

Parametri

NomeTipoDescrizione
columnPositionIntegerLa nuova posizione della colonna del controllo filtro.
filterCriteriaFilterCriteriaI nuovi criteri di filtro di questo controllo filtro.

Ritorni

Slicer: questo controllo filtro, per il concatenamento.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)

Imposta la posizione in cui viene visualizzato il controllo filtro sul foglio. Gli indici della riga di ancoraggio e della posizione della colonna sono indicizzati 1.

Parametri

NomeTipoDescrizione
anchorRowPosIntegerIl lato superiore del controllo filtro è ancorato a questa riga.
anchorColPosIntegerIl lato superiore del controllo filtro è ancorato in questa colonna.
offsetXIntegerLo scostamento orizzontale dall'angolo della cella in pixel.
offsetYIntegerL'offset verticale dall'angolo della cella in pixel.

Ritorni

Slicer: questo controllo filtro, per il concatenamento.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setRange(rangeApi)

Imposta l'intervallo di dati a cui viene applicato il controllo filtro.

Parametri

NomeTipoDescrizione
rangeApiRangeIl nuovo intervallo per questo controllo filtro.

Ritorni

Slicer: questo controllo filtro, per il concatenamento.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setTitle(title)

Imposta il titolo del controllo filtro. Un titolo vuoto reimposta il valore predefinito del titolo.

Parametri

NomeTipoDescrizione
titleStringIl nuovo titolo di questo controllo filtro.

Ritorni

Slicer: questo controllo filtro, per il concatenamento.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setTitleHorizontalAlignment(horizontalAlignment)

Consente di impostare l'allineamento orizzontale del titolo nel controllo filtro. Un valore null reimposta l'allineamento.

Parametri

NomeTipoDescrizione
horizontalAlignmentStringIl nuovo allineamento orizzontale del titolo di questo controllo filtro.

Ritorni

Slicer: questo controllo filtro, per il concatenamento.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setTitleTextStyle(textStyle)

Consente di impostare lo stile di testo del controllo filtro.

Parametri

NomeTipoDescrizione
textStyleTextStyleIl nuovo stile di testo del titolo del controllo filtro.

Ritorni

Slicer: questo controllo filtro, per il concatenamento.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

Metodi deprecati