Acessar e modificar tabelas dinâmicas.
Métodos
| Método | Tipo de retorno | Breve descrição |
|---|---|---|
add | Pivot | Cria um novo valor de pivô na tabela dinâmica calculado com base no formula especificado e no name especificado. |
add | Pivot | Define um novo agrupamento de colunas dinâmicas na tabela dinâmica. |
add | Pivot | Cria um filtro de dinamização para a tabela dinâmica. |
add | Pivot | Define um novo valor de coluna dinâmica na tabela dinâmica com o summarize especificado. |
add | Pivot | Define um novo agrupamento de linhas dinâmicas na tabela dinâmica. |
as | Data | Retorna a tabela dinâmica como uma tabela dinâmica de fonte de dados se ela estiver vinculada a um Data ou null caso contrário. |
get | Range | Retorna o Range que representa a célula em que a tabela dinâmica está ancorada. |
get | Pivot | Retorna uma lista ordenada dos grupos de colunas nesta tabela dinâmica. |
get | Pivot | Retorna uma lista ordenada dos filtros nesta tabela dinâmica. |
get | Pivot | Retorna uma lista ordenada dos valores dinâmicos nesta tabela dinâmica. |
get | Pivot | Retorna uma lista ordenada dos grupos de linhas nesta tabela dinâmica. |
get | Range | Retorna o intervalo de dados de origem em que a tabela dinâmica é construída. |
get | Dimension | Retorna se os valores são mostrados como linhas ou colunas. |
remove() | void | Exclui esta tabela dinâmica. |
set | Pivot | Define o layout da tabela dinâmica para mostrar valores como colunas ou linhas. |
Documentação detalhada
addCalculatedPivotValue(name, formula)
Cria um novo valor de pivô na tabela dinâmica calculado com base no formula especificado e no name especificado.
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
name | String | O nome desse valor de pivô calculado. |
formula | String | A fórmula usada para calcular esse valor. |
Retornar
PivotValue: o PivotValue recém-criado
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
addColumnGroup(sourceDataColumn)
Define um novo agrupamento de colunas dinâmicas na tabela dinâmica. O sourceDataColumn especificado indica a coluna nos dados de origem em que esse agrupamento se baseia.
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
source | Integer | O número da coluna que este grupo resume. Esse índice representa o número absoluto da coluna na planilha. 1 representa a coluna "A", 2 representa a coluna B e assim por diante. |
Retornar
PivotGroup: o PivotGroup recém-criado
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
addFilter(sourceDataColumn, filterCriteria)
Cria um filtro de dinamização para a tabela dinâmica. O sourceDataColumn especificado indica a coluna nos dados de origem em que esse filtro opera.
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
source | Integer | O número da coluna que este grupo resume. Esse índice representa o número absoluto da coluna na planilha. 1 representa a coluna "A", 2 representa a coluna B e assim por diante. |
filter | Filter | Os critérios de filtro usados para realizar a filtragem. |
Retornar
PivotFilter: o PivotFilter recém-criado
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
addPivotValue(sourceDataColumn, summarizeFunction)
Define um novo valor de coluna dinâmica na tabela dinâmica com o summarizeFunction especificado. O sourceDataColumn especificado indica a coluna nos dados de origem em que esse valor se baseia.
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
source | Integer | O número da coluna que este grupo resume. Esse índice representa o número absoluto da coluna na planilha. 1 representa a coluna "A", 2 representa a coluna B e assim por diante. |
summarize | Pivot |
Retornar
PivotValue: o PivotValue recém-criado
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
addRowGroup(sourceDataColumn)
Define um novo agrupamento de linhas dinâmicas na tabela dinâmica. O sourceDataColumn especificado indica a coluna nos dados de origem em que esse agrupamento se baseia.
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
source | Integer | O número da coluna que este grupo resume. Esse índice representa o número absoluto da coluna na planilha. 1 representa a coluna "A", 2 representa a coluna B e assim por diante. |
Retornar
PivotGroup: o PivotGroup recém-criado
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
asDataSourcePivotTable()
Retorna a tabela dinâmica como uma tabela dinâmica de fonte de dados se ela estiver vinculada a um DataSource ou null caso contrário.
Retornar
DataSourcePivotTable|null: uma tabela dinâmica da fonte de dados.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
getAnchorCell()
Retorna o Range que representa a célula em que a tabela dinâmica está ancorada.
Retornar
Range: célula de ancoragem da tabela dinâmica
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
getColumnGroups()
Retorna uma lista ordenada dos grupos de colunas nesta tabela dinâmica.
Retornar
PivotGroup[]: os grupos de colunas nesta tabela dinâmica
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
getFilters()
Retorna uma lista ordenada dos filtros nesta tabela dinâmica.
Retornar
PivotFilter[]: os filtros nesta tabela dinâmica
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
getPivotValues()
Retorna uma lista ordenada dos valores dinâmicos nesta tabela dinâmica.
Retornar
PivotValue[]: os valores dinâmicos nesta tabela dinâmica
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
getRowGroups()
Retorna uma lista ordenada dos grupos de linhas nesta tabela dinâmica.
Retornar
PivotGroup[]: os grupos de linhas nesta tabela dinâmica
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
getSourceDataRange()
Retorna o intervalo de dados de origem em que a tabela dinâmica é construída.
Retornar
Range: o intervalo de dados de origem desta tabela dinâmica.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
getValuesDisplayOrientation()
Retorna se os valores são mostrados como linhas ou colunas.
Retornar
Dimension: se os valores são mostrados como linhas ou colunas
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
remove()
Exclui esta tabela dinâmica. Outras operações nessa tabela dinâmica resultam em um erro.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
setValuesDisplayOrientation(dimension)
Define o layout da tabela dinâmica para mostrar valores como colunas ou linhas.
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
dimension | Dimension | A dimensão que indica como mostrar os valores de rotação. |
Retornar
PivotTable: a tabela dinâmica para encadeamento
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets