Classe PivotTable - um relatório de tabela dinâmica em uma planilha (Excel VBA)
A classe PivotTable representa um relatório de tabela dinâmica em uma planilha.
As classes PivotCache, PivotCell, PivotLayout, Range e Worksheet. dão acesso à classe PivotTable
Dim pvt as PivotTable
Set pvt = ActiveCell.PivotTable
For Each
Aqui está um exemplo de processamento dos itens PivotTable em uma coleção.
Dim pvt As PivotTable
For Each pvt In Application.PivotTables
Next pvt
Métodos
GetPivotData - Retorna um objeto Range com informações sobre um item de dados em um relatório de tabela dinâmica.
Dim rngGetPivotData As Range
Set rngGetPivotData = ActiveCell.PivotTable.GetPivotData()AddDataField - Adiciona um campo de dados a um relatório de tabela dinâmica. Retorna um objeto PivotField que representa o novo campo de dados.
AddFields - Adiciona campos de linha, de coluna e de página a um relatório de tabela dinâmica ou de gráfico dinâmico.
AllocateChanges - Executa uma operação de write-back para todas as células editadas em um relatório da Tabela Dinâmica com base em uma fonte de dados OLAP.
CalculatedFields - Retorna uma coleção CalculatedFields que representa todos os campos calculados no relatório de tabela dinâmica especificado. Somente leitura.
ChangeConnection - Altera a conexão do objeto PivotTable especificado.
ChangePivotCache - Altera o objeto PivotCache da tabela dinâmicaespecificada.
ClearAllFilters - O método ClearAllFilters exclui todos os filtros atualmente aplicados a PivotTable. Isso inclui a exclusão de todos os filtros na coleção PivotFilters , a remoção de qualquer filtragem manual aplicada e a configuração de todos os campos PivotFields na área de filtro de relatório para o item padrão.
ClearTable - O método ClearTable é utilizado para limpar uma PivotTable. A limpeza de PivotTables inclui a remoção de todos os campos e a exclusão de todas as filtragens e classificação aplicadas a PivotTables. Este método redefine a PivotTable para o estado que ela tinha logo após ela ser criada, antes que quaisquer campos fossem adicionados a ela.
CommitChanges - Executa uma operação de confirmação na fonte de dados de um relatório de tabela dinâmica com base em uma fonte de dados OLAP.
ConvertToFormulas - O método ConvertToFormulas é usado para converter uma tabela dinâmica em fórmulas de cubo. Boolean de leitura/gravação.
CreateCubeFile - Cria um arquivo de cubo de um relatório de tabela dinâmica conectado a uma fonte de dados OLAP Online Analytical Processing.
DiscardChanges - Descarta todas as alterações nas células editadas de um relatório de Tabela Dinâmica com base em uma fonte de dados OLAP.
DrillDown - Permite detalhar os dados dentro de uma hierarquia de cubos baseada em OLAP ou no PowerPivot.
DrillTo - Permite analisar um local em uma hierarquia de cubos baseada em OLAP ou no PowerPivot.
DrillUp - Permite que você faça drill up nos dados de uma hierarquia de cubos baseada em OLAP ou no PowerPivot.
GetData - Retorna o valor dos dados arquivados em uma tabela dinâmica.
ListFormulas - Cria uma lista dos itens e campos calculados da tabela dinâmica em uma planilha separada.
PivotCache - Retorna um objeto PivotCache que representa o cache para o relatório de tabela dinâmica especificado. Somente leitura.
PivotFields - Retorna um objeto que representa um único campo de tabela dinâmica um objeto PivotField ou uma coleção de ambos os campos Visible e Hidden (um objeto PivotFields ) no relatório de tabela dinâmica. Somente leitura.
PivotSelect - Seleciona parte de um relatório de tabela dinâmica.
PivotTableWizard - Cria e retorna um objeto PivotTable. Este método não exibe o assistente de tabela dinâmica. Este método não está disponível para fontes de dados OLE DB. Use o método Add para adicionar um cache de tabela dinâmica e, em seguida, crie um relatório de tabela dinâmica com base no cache.
PivotValueCell - Recupere o objeto PivotValueCell para uma determinada tabela dinâmica, desde determinados índices de linhas e colunas.
RefreshDataSourceValues - Recupera os valores atuais da fonte de dados para todas as células editadas em um relatório de Tabela Dinâmica que esteja em modo de write-back.
RefreshTable - Atualiza o relatório de tabela dinâmica a partir dos dados de origem. Retorna true se for bem-sucedido.
RepeatAllLabels - Especifica se rótulos de item devem ou não ser repetidos para todas as Tabelas Dinâmicas na Tabela Dinâmica especificada.
RowAxisLayout - Método usado para definir simultaneamente opções de layout para todos os PivotFields existentes.
ShowPages - Cria um novo relatório de tabela dinâmica para cada item do campo de página. Cada novo relatório é criado em uma nova planilha.
SubtotalLocation - Esse método altera a localização do subtotal de todos os campo dinâmicos existentes. Alterar a localização do campo dinâmico tem um efeito visual imediato somente para campos em formato de estrutura de tópicos, mas ele também será definido para campos em formato tabular.
Update - Atualiza o relatório de tabela dinâmica selecionado.
Propriedades
Value (Default member) - Retorna ou define um valor String que representa o nome do relatório de tabela dinâmica.
ActiveFilters Indica o filtro atualmente ativo na PivotTable especificada. Somente leitura.
Allocation Retorna ou define se é para executar uma instrução Update Cube para cada célula que é editada, ou somente quando o usuário escolhe calcular alterações ao executar uma análise de hipóteses em uma tabela dinâmica com base em uma fonte de dados OLAP. Leitura/gravação.
AllocationMethod Retorna ou define o método a ser usado para alocar valores ao executar a análise de hipóteses em um relatório de tabela dinâmica com base em uma fonte de dados OLAP. Leitura/gravação.
AllocationValue Retorna ou define o valor a ser alocado ao executar a análise de hipóteses em um relatório de tabela dinâmica com base em uma fonte de dados OLAP. Leitura/gravação.
AllocationWeightExpression Retorna ou define a expressão de peso MDX que será usada ao executar teste de hipóteses em uma Tabela Dinâmica com base em uma fonte de dados OLAP. Leitura/gravação.
AllowMultipleFilters Define ou recupera um valor que indica se um PivotField pode ter vários filtros aplicados a ele ao mesmo tempo. Boolean de leitura/gravação.
AlternativeText Retorna ou define a cadeia de caracteres de texto descritivo alternativo para a Tabela Dinâmica. Leitura/gravação.
CacheIndex Retorna ou define o número de índice do cache da tabela dinâmica. Long de leitura/gravação.
CalculatedMembers Retorna uma coleção CalculatedMembers que representa todos os membros calculados e medidas calculadas para uma tabela dinâmica OLAP.
CalculatedMembersInFilters Retorna ou define se membros calculados de servidores OLAP devem ser avaliados em filtros. Leitura/gravação.
ChangeList Retorna a coleção PivotTableChangeList que representa a lista de alterações feitas na tabela dinâmica especificada com base em uma fonte de dados OLAP. Somente leitura.
ColumnFields Retorna um objeto que representa um único campo de tabela dinâmica um objeto PivotField ou uma coleção de todos os campos (um objeto PivotFields ) que são mostrados atualmente como campos de coluna. Somente leitura.
ColumnGrand True se o relatório de tabela dinâmica exibir totais gerais para colunas. Boolean de leitura/gravação.
ColumnRange Retorna um objeto Range que representa o intervalo que contém a área de coluna no relatório de tabela dinâmica. Somente leitura.
CompactLayoutColumnHeader Especifica a legenda que será exibida no cabeçalho da coluna de uma PivotTable quando estiver no formato de layout de linha compacta. String de leitura/gravação.
CompactLayoutRowHeader Especifica a legenda que será exibida no cabeçalho da linha de uma PivotTable quando estiver no formato de layout de linha compacta. String de leitura/gravação.
CompactRowIndent Retorna ou define o incremento de recuo para PivotItems quando o formato de layout de linha compacta está ativado. Leitura/gravação.
CubeFields Retorna a coleção CubeFields . Cada objeto cubefield contém as propriedades do elemento de campo de cubo. Somente leitura.
DataBodyRange Retorna um objeto Range que representa o intervalo de valores em uma tabela dinâmica. Somente leitura.
DataFields Retorna um objeto que representa um único campo de tabela dinâmica um objeto PivotField ou uma coleção de todos os campos (um objeto PivotFields ) atualmente exibidos como campos de dados. Somente leitura.
DataLabelRange Retorna um objeto Range que representa o intervalo que contém os rótulos dos campos de dados no relatório de tabela dinâmica. Somente leitura.
DataPivotField Retorna um objeto PivotField que representa todos os campos de dados em uma tabela dinâmica. Somente leitura.
DisplayContextTooltips Controla se as dicas de ferramentas são exibidas para as células da tabela dinâmica. Boolean de leitura/gravação.
DisplayEmptyColumn Retorna True quando a palavra-chave MDX não vazia é incluída na consulta no provedor OLAP pelo eixo de valores. O provedor OLAP não retornará colunas vazias no conjunto de resultados. Retorna False quando a palavra-chave não vazia é omitida. Boolean de leitura/gravação.
DisplayEmptyRow Retorna True quando a palavra-chave MDX não vazia é incluída na consulta ao provedor OLAP pelo eixo de categoria. O provedor OLAP não retornará linhas vazias no conjunto de resultados. Retorna False quando a palavra-chave não vazia é omitida. Boolean de leitura/gravação.
DisplayErrorString True se o relatório de tabela dinâmica exibir uma sequência de erro personalizada em células que contêm erros. O valor padrão é False. Boolean de leitura/gravação.
DisplayFieldCaptions Controla se os botões de filtro e as legendas de PivotField para linhas e colunas são exibidos na grade. Leitura/gravação.
DisplayImmediateItems Retorna ou define um Boolean que indica se os itens nas áreas de linha ou de coluna são visíveis quando a área de dados da tabela dinâmica está vazia. Defina essa propriedade como False para ocultar os itens nas áreas de linha e de coluna quando a área de dados da tabela dinâmica estiver vazia. O valor padrão é True.
DisplayMemberPropertyTooltips Controla se as propriedades do membro devem ser exibidas em dicas de ferramentas. Boolean de leitura/gravação.
DisplayNullString True se o relatório de tabela dinâmica exibir uma sequência personalizada em células que contém valores nulos. O valor padrão é True. Boolean de leitura/gravação.
EnableDataValueEditing True para desativar o alerta para quando o usuário substituir valores na área de dados da tabela dinâmica. True também permite que o usuário altere valores de dados que não podiam ser alterados anteriormente. O valor padrão é False. Boolean de leitura/gravação.
EnableDrilldown True se o drilldown for ativado. O valor padrão é True. Boolean de leitura/gravação.
EnableFieldDialog True se a caixa de diálogo campo da tabela dinâmica estiver disponível quando o usuário clicar duas vezes no campo da tabela dinâmica. O valor padrão é True. Boolean de leitura/gravação.
EnableFieldList False para desabilitar a capacidade de exibir a lista de campos da tabela dinâmica. Se a lista de campos já estava sendo exibida, ela desaparece. O valor padrão é True. Boolean de leitura/gravação.
EnableWizard True se o assistente de tabela dinâmica estiver disponível. O valor padrão é True. Boolean de leitura/gravação.
EnableWriteback Retorna ou define se o write-back na fonte de dados está habilitado para a Tabela Dinâmica especificada. O valor padrão é False. Leitura/gravação.
ErrorString Retorna ou define um valor String que representa a sequência de caracteres exibida nas células que contêm erros quando a propriedade DisplayErrorString é True.
FieldListSortAscending Controla a ordem de classificação de campos na Lista de Campos da Tabela Dinâmica. Quando essa propriedade é definida como True, os campos são classificados em ordem ascendente. Quando ela é definida como False, os campos são classificados na ordem da fonte da dados. Leitura/gravação.
GrandTotalName Retorna ou define o rótulo da sequência de caracteres de texto exibido no título de coluna ou linha Total no relatório de tabela dinâmica especificado. O valor padrão é a cadeia de caracteres de total geral. String de leitura/gravação.
HasAutoFormat True se o relatório de tabela dinâmica é formatado automaticamente quando é atualizado ou quando os campos são movidos. Boolean de leitura/gravação.
Hidden Verifica se a tabela dinâmica existe no nível da planilha. Boolean somente leitura.
HiddenFields Retorna um objeto que representa um único campo de tabela dinâmica um objeto PivotField ou uma coleção de todos os campos (um objeto PivotFields ) que não são exibidos atualmente como campos de linha, coluna, página ou dados. Somente leitura.
InGridDropZones Propriedade usada para ativar/desativar zonas para soltar na grade de um objeto PivotTable. Em alguns casos, ela também afeta o layout da tabela dinâmica. Boolean de leitura/gravação.
InnerDetail Retorna ou define o nome do campo que será exibido como detalhe quando a propriedade ShowDetail for True para o campo de linha ou de coluna mais interno. String de leitura/gravação.
LayoutRowDefault Esta propriedade especifica as configurações de layout de PivotFields quando adicionados à tabela dinâmica pela primeira vez. Leitura/gravação XlLayoutRowType.
Location Obtém ou define uma cadeia de caracteres que representa a célula superior esquerda no corpo do objeto de tabela dinâmica especificado. Leitura/gravação.
ManualUpdate True se o relatório de tabela dinâmica só for recalculado a pedido do usuário. O valor padrão é False. Boolean de leitura/gravação.
MDX Retorna um String que indica o MDX Multidimensional Expression que seria enviado ao provedor para preencher o modo de tabela dinâmica. Somente leitura.
MergeLabels True se o item de linha externa do relatório de tabela dinâmica, o item de coluna, o SUBTOTAL e os rótulos gerais principais usam células mescladas. Boolean de leitura/gravação.
Name Retorna ou define um valor String que representa o nome do objeto.
NullString Retorna ou define a cadeia de caracteres exibida nas células que contêm valores nulos quando a propriedade DisplayNullString é true. O valor padrão é uma cadeia de caracteres vazia "". String de leitura/gravação.
PageFieldOrder Retorna ou define a ordem na qual os campos de página são adicionados ao layout do relatório de tabela dinâmica. Pode ser uma das seguintes constantes XlOrder : xlDownThenOver ou xlOverThenDown. A constante padrão é xlDownThenOver. Long de leitura/gravação.
PageFields Retorna um objeto que representa um único campo de tabela dinâmica um objeto PivotField ou uma coleção de todos os campos (um objeto PivotFields ) que estão sendo mostrados atualmente como campos de página. Somente leitura.
PageFieldStyle Retorna ou define o estilo usado na área de campo de página acoplada. O valor padrão é uma sequência de caracteres nula nenhum estilo é aplicado por padrão. String de leitura/gravação.
PageFieldWrapCount Retorna ou define o número de campos de página em cada coluna ou linha no relatório de tabela dinâmica. Long de leitura/gravação.
PageRange Retorna um objeto Range que representa o intervalo que contém a área de página no relatório de tabela dinâmica. Somente leitura.
PageRangeCells Retorna um objeto Range que representa somente as células no relatório de tabela dinâmica especificado que contêm os campos de página e as listas suspensas de itens.
PivotChart Retorna um objeto Shape que representa o gráfico autônomo para o relatório de tabela dinâmica oculto especificado. Somente leitura.
PivotColumnAxis Retorna um objeto PivotAxis representando o eixo de coluna inteiro. PivotAxis somente leitura.
PivotFormulas Retorna um objeto PivotFormulas que representa a coleção de fórmulas para o relatório de tabela dinâmica especificado. Somente leitura.
PivotRowAxis Retorna um objeto PivotAxis representando o eixo de linha inteiro. PivotAxis somente leitura.
PivotSelection Retorna ou define a seleção da tabela dinâmica no formato padão de seleção de relatório de tabela dinâmica. String de leitura/gravação.
PivotSelectionStandard Retorna ou define um String que indica a seleção da tabela dinâmica em um formato de relatório de tabela dinâmica padrão usando as definições Inglês Estados Unidos. Leitura/gravação.
PreserveFormatting True se a formatação é preservada quando o relatório é atualizado ou recalculado por operações como dinamização, classificação ou alteração de itens de campo de página.
PrintDrillIndicators Especifica se os indicadores de análise são impressos com a tabela dinâmica. Boolean de leitura/gravação.
PrintTitles True se os títulos de impressão para a planilha forem definidos com base no relatório de tabela dinâmica. False se os títulos de impressão para a planilha forem usados. O valor padrão é False. Boolean de leitura/gravação.
RefreshDate Retorna a data em que o relatório de tabela dinâmica foi atualizado pela última vez. Date somente leitura.
RefreshName Retorna o nome da pessoa que atualizou os dados do relatório de tabela dinâmica pela última vez. String somente leitura.
RepeatItemsOnEachPrintedPage True se rótulos de linhas, colunas e itens forem exibidos na primeira linha de cada página quando o relatório de tabela dinâmica especificado for impresso. False se os rótulos só forem impressos na primeira página. O valor padrão é True. Boolean de leitura/gravação.
RowFields Retorna um objeto que representa um único campo em um relatório de tabela dinâmica um objeto PivotField ou uma coleção de todos os campos (um objeto PivotFields ) que estão sendo mostrados atualmente como campos de linha. Somente leitura.
RowGrand True se o relatório de tabela dinâmica exibir totais gerais para linhas. Boolean de leitura/gravação.
RowRange Retorna um objeto Range que representa o intervalo, incluindo a área de linha no relatório de tabela dinâmica. Somente leitura.
SaveData True se os dados do relatório de tabela dinâmica forem salvos com a pasta de trabalho. False se somente a definição de relatório for salva. Boolean de leitura/gravação.
SelectionMode Retorna ou define o modo de seleção estruturada do relatório de tabela dinâmica. Leitura/gravação XlPTSelectionMode.
ShowDrillIndicators A propriedade ShowDrillIndicators é usada para alternar a exibição de indicadores de análise na tabela dinâmica. Boolean de leitura/gravação.
ShowPageMultipleItemLabel Quando for definida como True padrão, "(Vários itens)" será exibido na célula da tabela dinâmica da planilha sempre que os itens estiverem ocultos, e um conjunto de itens não ocultos será mostrado no modo de tabela dinâmica. Boolean de leitura/gravação.
ShowTableStyleColumnHeaders A propriedade ShowTableStyleColumnHeaders é definida como true se os cabeçalhos de coluna devem ser exibidos na tabela dinâmica. Boolean de leitura/gravação.
ShowTableStyleColumnStripes A propriedade ShowTableStyleColumnStripes exibe colunas em tiras nas quais colunas pares são formatas de forma diferente das colunas ímpares. Isso facilita a leitura as tabelas dinâmicas. Boolean de leitura/gravação.
ShowTableStyleLastColumn Retorna ou define se a última coluna é exibida para o objeto PivotTable especificado. Boolean de leitura/gravação.
ShowTableStyleRowHeaders A propriedade ShowTableStyleRowHeaders é definida como true se os cabeçalhos de linha devem ser exibidos na tabela dinâmica. Boolean de leitura/gravação.
ShowTableStyleRowStripes A propriedade ShowTableStyleRowStripes exibe linhas em tiras nas quais linhas pares são formatas de forma diferente das linhas ímpares. Isso facilita a leitura as tabelas dinâmicas. Boolean de leitura/gravação.
ShowValuesRow Retorna ou define se a linha de valores é exibida. Leitura/gravação.
Slicers Retorna a coleção slicers para a tabela dinâmica especificada. Somente leitura.
SmallGrid True se o Microsoft Excel usa uma grade que tenha duas células de largura e duas células de profundidade para um relatório de tabela dinâmica criado recentemente. False se o Excel usar um contorno estêncil em branco. Boolean de leitura/gravação.
SortUsingCustomLists A propriedade SortUsingCustomLists controla se as listas personalizadas são usadas para classificar itens de campos, inicialmente quando o PivotField é inicializado e o PivotItems é ordenado por suas legendas e, posteriormente, quando o usuário aplica uma classificação. Boolean de leitura/gravação.
SourceData Retorna a fonte de dados para um relatório de tabela dinâmica, como mostra a tabela a seguir. de leitura/gravação.
SubtotalHiddenPageItems True se os itens de campo de página ocultos do relatório de tabela dinâmica forem incluídos em subtotais de linha e coluna, totais de bloco e totais gerais. O valor padrão é False. Boolean de leitura/gravação.
Summary Retorna ou define a descrição associada à cadeia de caracteres alternativa da Tabela Dinâmica especificada. Leitura/gravação.
TableRange1 Retorna um objeto Range que representa o intervalo que contém o relatório de tabela dinâmica inteiro, mas não inclui campos de página. Somente leitura.
TableRange2 Retorna um objeto Range que representa o intervalo que contém o relatório de tabela dinâmica inteiro, incluindo campos de página. Somente leitura.
TableStyle2 A propriedade TableStyle2 especifica o estilo aplicado no momento à tabela dinâmica. Leitura/gravação.
Tag Retorna ou define uma sequência de caracteres salva com o relatório de tabela dinâmica. String de leitura/gravação.
TotalsAnnotation True se um asterisco * é exibido ao lado de cada valor de subtotal e total geral no relatório de tabela dinâmica especificado se o relatório for baseado em uma fonte de dados OLAP. O valor padrão é True. Boolean de leitura/gravação.
VacatedStyle Retorna ou define o estilo aplicado às células tornadas vagas quando o relatório de tabela dinâmica é atualizado. O valor padrão é uma sequência de caracteres nula nenhum estilo é aplicado por padrão. String de leitura/gravação.
Version Retorna um valor XlPivotTableVersionList que representa o número da versão do Microsoft Excel.
ViewCalculatedMembers Quando definida como True padrão, os membros calculados de tabelas dinâmicas OLAP (Online Analytical Processing) podem ser visualizados. Boolean de leitura/gravação.
VisibleFields Retorna um objeto que representa um único campo em um relatório de tabela dinâmica um objeto PivotField ou uma coleção de todos os campos visíveis (um objeto PivotFields ). Os campos visíveis são exibidos como campos de linha, coluna, página ou dados. Somente leitura.
VisualTotals True padrão para permitir que as tabelas dinâmicas OLAP (Online Analytical Processing) calculem novamente um total depois que um item foi ocultado. Boolean de leitura/gravação.
VisualTotalsForSets Retorna ou define se os itens filtrados devem ser incluídos nos totais de conjuntos nomeados para a tabela dinâmica especificada. Leitura/gravação.
Related Classes
CalculatedFields - Uma coleção de objetos PivotField que representa todos os campos calculados no relatório de tabela dinâmica especificado.
CalculatedMembers - Uma coleção de todos os objetos CalculatedMember na tabela dinâmica especificada.
CubeFields - Uma coleção de todos os objetos cubefield em um relatório de tabela dinâmica com base em um cubo OLAP. Cada objeto CubeField representa um campo de hierarquia ou de medida do cubo.
PivotAxis - O objeto PivotAxis é usado para análise assimétrica em uma tabela dinâmica.
PivotCache - Representa o cache de memória para um relatório de tabela dinâmica.
PivotField - Representa um campo em um relatório de tabela dinâmica.
PivotFields - Uma coleção de todos os objetos PivotField em um relatório de tabela dinâmica.
PivotFilters - O objeto PivotFilters é uma coleção de objetos PivotFilter .
PivotFormulas - Representa a coleção de fórmulas para um relatório de tabela dinâmica. Cada fórmula é representada por um objeto PivotFormula .
PivotTableChangeList - Representa a lista de alterações feitas por um usuário nas células de valor em um relatório de tabela dinâmica com base em uma fonte de dados OLAP.
PivotValueCell - Fornece uma maneira de expor valores de células caso as células reais (objetosRange ) não estejam disponíveis.
Range - Representa uma célula, uma linha, uma coluna, uma seleção de células contendo um ou mais blocos contíguos de células ou um intervalo 3D.
Shape - Representa um objeto na camada de desenho, como uma AutoForma, uma forma livre, um objeto OLE ou uma imagem.
Slicers - Uma coleção de objetos slicery.