PivotTable Interface

Definição

Representa um relatório de tabela dinâmica em uma planilha. O objeto PivotTable é um membro da PivotTables coleção. A coleção PivotTables contém todos os objetos PivotTable de uma única planilha.

public interface class PivotTable
[System.Runtime.InteropServices.Guid("00020872-0000-0000-C000-000000000046")]
[System.Runtime.InteropServices.InterfaceType(2)]
public interface PivotTable
Public Interface PivotTable
Atributos

Comentários

Use Tabelas Dinâmicas( ), onde está o número ou o nome do índice de tabela dinâmica, para index retornar um único objeto index PivotTable.

Como a programação de relatório de Tabela Dinâmica pode ser complexa, geralmente é mais fácil registrar ações de relatório de Tabela Dinâmica e examinar o código gravado. Para gravar uma macro, aponte para Macro no menu Ferramentas e clique em Gravar Nova Macro.

Propriedades

_Default

Reservado para uso interno.

ActiveFilters

Indica o filtro ativo no momento no PivotTable especificado . Somente leitura.

Allocation

Obtém ou define se uma instrução UPDATE CUBE para cada célula é editada ou somente quando o usuário opta por calcular as alterações ao executar a análise de what-if em uma tabela dinâmica com base em uma fonte de dados OLAP.

AllocationMethod

Obtém ou define qual método usar para alocar valores ao executar a análise de what-if em um relatório de tabela dinâmica com base em uma fonte de dados OLAP.

AllocationValue

Obtém ou define qual valor alocar ao executar a análise de what-if em um relatório de tabela dinâmica com base em uma fonte de dados OLAP.

AllocationWeightExpression

Obtém ou define a expressão de peso MDX a ser usada ao executar a análise de what-if em um relatório de tabela dinâmica com base em uma fonte de dados OLAP.

AllowMultipleFilters

Define ou recupera um valor que indica se um pode ter vários filtros aplicados a PivotField ele ao mesmo tempo. Leitura/gravação.

AlternativeText

Obtém ou define a cadeia de caracteres de texto descritiva (alternativa) para a Tabela Dinâmica especificada.

Application

Retorna um Application objeto que representa o Microsoft Excel aplicativo. Somente leitura.

CacheIndex

Retorna ou define o número de índice do cache da tabela dinâmica. número inteiro de leitura/gravação.

CalculatedMembers

Retorna uma coleção que representa todos os membros calculados e CalculatedMembers medidas calculadas para uma Tabela Dinâmica OLAP.

CalculatedMembersInFilters

Obtém ou define se deve avaliar membros calculados de servidores OLAP em filtros.

ChangeList

Obtém a coleção que representa a lista de alterações que foram feitas na Tabela Dinâmica especificada com base PivotTableChangeList em uma fonte de dados OLAP.

ColumnFields[Object]

Retorna um objeto que representa um único campo de tabela dinâmica (um objeto) ou uma coleção de todos os campos (um objeto) atualmente mostrados como campos PivotField PivotFields de coluna. Somente leitura.

ColumnGrand

True se o relatório de tabela dinâmica mostrar os totais gerais para colunas. Boolean de leitura/gravação

ColumnRange

Retorna um Range objeto que representa o intervalo que contém a área de coluna no relatório de tabela dinâmica. Somente leitura.

CompactLayoutColumnHeader

Especifica a legenda exibida no header da coluna de um quando no formato de layout de linha PivotTable compacta. Leitura/gravação.

CompactLayoutRowHeader

Especifica a legenda exibida no header de linha de um quando no formato de layout de linha PivotTable compacta. Leitura/gravação.

CompactRowIndent

Retorna ou define o incremento de recuo para quando o formulário de layout de linha PivotItems compacta está ligado. Leitura/gravação.

Creator

Retorna um inteiro de 32 bits que indica o aplicativo no qual esse objeto foi criado. Se o objeto foi criado no Microsoft Excel, essa propriedade retornará a sequência XCEL, que é equivalente ao número hexadecimal 5843454C. Somente leitura XlCreator .

CubeFields

Retorna a CubeFields coleção. Cada CubeField objeto contém as propriedades do elemento de campo de cubo. Somente leitura.

DataBodyRange

Retorna um objeto que representa o intervalo que contém a área de dados na lista entre a linha Range de header e a linha de inserção. Somente leitura.

DataFields[Object]

Retorna um objeto que representa um único campo de tabela dinâmica (um objeto) ou uma coleção de todos os campos (um objeto) atualmente mostrados como PivotField PivotFields campos de dados. Somente leitura.

DataLabelRange

Retorna um objeto que representa o intervalo que contém os rótulos dos campos Range de dados no relatório de tabela dinâmica. Somente leitura.

DataPivotField

Retorna um PivotField objeto que representa todos os campos de dados em uma tabela dinâmica. Somente leitura.

DisplayContextTooltips

Controla se as dicas de ferramenta são exibidas ou não para PivotTable células. 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 e legendas de filtro para linhas e colunas são PivotField 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 a exibição ou não de propriedades membro nas dicas de ferramentas. 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á foi exibida, ele desaparece. O valor padrão é True. Leitura/gravação booleano.

EnableWizard

True se o Assistente de Tabela Dinâmica estiver disponível. O valor padrão é True. Leitura/gravação booleano.

EnableWriteback

Obtém ou define se a escrita de volta à fonte de dados está habilitada para a Tabela Dinâmica especificada.

ErrorString

Retorna ou define a cadeia de caracteres exibida em células que contêm erros quando a DisplayErrorString propriedade é True. O valor padrão é uma cadeia de caracteres vazia (""). String de leitura/gravação.

FieldListSortAscending

Controla a ordem de classificação de campos na PivotTable Lista de Campos. 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 sequência "Grand Total". String de leitura/gravação

HasAutoFormat

True se o relatório de tabela dinâmica for formatado automaticamente quando ele for 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 (bool no C#). Somente leitura

HiddenFields[Object]

Retorna um objeto que representa um único campo de tabela dinâmica (um objeto) ou uma coleção de todos os campos (um objeto) que atualmente não são mostrados como campos de linha, coluna, página ou PivotField PivotFields dados. Somente leitura.

InGridDropZones

Essa propriedade é usada para alternar zonas de drop na grade para um PivotTable objeto. Em alguns casos, ele também afeta o layout do PivotTable . Leitura/gravação.

InnerDetail

Retorna ou define o nome do campo que será mostrado como detalhe quando a propriedade for True para o campo de linha ou ShowDetail coluna mais interno. String de leitura/gravação.

LayoutRowDefault

Essa propriedade especifica as configurações de layout PivotFields para quando elas são adicionadas à primeira PivotTable vez. Leitura/gravação.

Location

Obtém ou define um String que representa a célula superior esquerda no corpo do PivotTable . 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 uma cadeia de caracteres que indica o MDX (Expressão Multidimensional) que seria enviado ao provedor para preencher o modo de exibição de tabela dinâmica atual. Somente leitura.

MergeLabels

True se os rótulos de item de linha externa, item de coluna, subtotal e total geral do relatório especificado da tabela dinâmica usarem células mescladas. Boolean de leitura/gravação.

Name

Retorna ou define o nome do objeto. String de leitura/gravação.

NullString

Retorna ou define a cadeia de caracteres exibida em células que contêm valores nulos quando a DisplayNullString propriedade é 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 XlOrder constantes: xlDownThenOver ou xlOverThenDown. A constante padrão é xlDownThenOver. número inteiro de leitura/gravação.

PageFields[Object]

Retorna um objeto que representa um único campo de tabela dinâmica (um objeto) ou uma coleção de todos os campos (um objeto) que estão sendo exibidos no momento como campos PivotField PivotFields 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. número inteiro de leitura/gravação.

PageRange

Retorna um Range objeto 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 que representa apenas as células no relatório de tabela dinâmica especificado que contém os campos de página e listas Range listadas de itens.

Parent

Retorna o objeto pai do objeto especificado. Somente leitura

PivotChart

Retorna um objeto que representa a Gráfico Dinâmico do relatório Shape de tabela dinâmica oculto especificado. Somente leitura.

PivotColumnAxis

Retorna um PivotAxis objeto que representa todo o eixo da coluna. Somente leitura.

PivotFormulas

Retorna um PivotFormulas objeto que representa a coleção de fórmulas do relatório PivotTable especificado. Somente leitura.

PivotRowAxis

Retorna um PivotAxis objeto que representa todo o eixo da linha. 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

Essa propriedade será True se a formatação for preservada quando o relatório for atualizado ou recalculado por operações como pivoting, classificação ou alteração de itens de campo de página. Boolean de leitura/gravação.

PrintDrillIndicators

Especifica se os indicadores de broca são impressos ou não com PivotTable o . 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. DateTime somente leitura.

RefreshName

Retorna o nome da pessoa que atualizeu pela última vez os dados do relatório de tabela dinâmica ou o cache de tabela dinâmica. 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[Object]

Retorna um objeto que representa um único campo em um relatório de tabela dinâmica (um objeto) ou uma coleção de todos os campos (um objeto) que estão sendo mostrados no momento como campos PivotField PivotFields 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 Range objeto 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. XlPTSelectionModeLeitura/gravação.

ShowCellBackgroundFromOLAP

True se o MDX (Expressão Multidimensional) que o Microsoft Excel envia para o servidor incluir a propriedade para cada célula na área de dados que corresponde a uma célula no conjunto de dados BackColor OLAP (Online Analytical Processing). O valor padrão é False. Leitura/gravação booleano.

ShowDrillIndicators

A ShowDrillIndicators propriedade é usada para a agregação da exibição de indicadores de broca no PivotTable . 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 será definida como True se os headers da ShowTableStyleColumnHeaders coluna devem ser exibidos no PivotTable . Leitura/gravação.

ShowTableStyleColumnStripes

A propriedade Boolean exibe colunas em faixa nas quais até mesmo colunas são formatadas de forma diferente de colunas ímpares. Isso facilita PivotTables a leitura. Leitura/gravação.

ShowTableStyleLastColumn

Reservado para uso interno.

ShowTableStyleRowHeaders

A ShowTableStyleRowHeaders propriedade é definida como True se os headers de linha devem ser exibidos no PivotTable . Leitura/gravação.

ShowTableStyleRowStripes

A propriedade exibe linhas em faixa nas quais linhas de mesmo tipo são formatadas de ShowTableStyleRowStripes forma diferente de linhas ímpares. Isso facilita PivotTables a leitura. Leitura/gravação.

ShowValuesRow

Obtém ou define se a linha de valores é exibida.

Slicers

Obtém Slicers a coleção da tabela dinâmica especificada.

SmallGrid

True se o Microsoft Excel usar 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 controla se listas personalizadas são usadas para classificar itens de campos, inicialmente quando o é inicializado e o é ordenado por suas legendas; e posterior quando o usuário aplica SortUsingCustomLists PivotField uma PivotItems classificação. Leitura/gravação.

SourceData

Retorna a fonte de dados do relatório de tabela dinâmica. Objeto read-write.

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

Obtém ou define a descrição associada à cadeia de caracteres de texto alternativa para a Tabela Dinâmica especificada.

TableRange1

Retorna um objeto que representa o intervalo que contém todo o relatório de tabela Range dinâmica, mas não inclui campos de página. Somente leitura.

TableRange2

Retorna um Range objeto que representa o intervalo que contém todo o relatório de tabela dinâmica, incluindo campos de página. Somente leitura.

TableStyle

Retorna ou define o estilo usado no corpo do relatório de tabela dinâmica. O valor padrão é uma sequência de caracteres nula (nenhum estilo é aplicado por padrão). String de leitura/gravação.

TableStyle2

A TableStyle2 propriedade especifica o estilo atualmente aplicado ao PivotTable PivotTable . 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 (*) for exibido próximo de cada subtotal e total geral no relatório de tabela dinâmica especificado caso o relatório seja 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.

Value

O nome do relatório de tabela dinâmica. String de leitura/gravação.

Version

Retorna o Microsoft Excel de versão. Somente leitura XlPivotTableVersionList .

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[Object]

Retorna um objeto que representa um único campo em um relatório de tabela dinâmica (um objeto) ou uma coleção de todos os campos PivotField visíveis (um PivotFields objeto). Os campos visíveis são mostrados como campos de linha, coluna, página ou dados. Somente leitura.

VisualTotals

True (padrão) para habilitar Tabelas Dinâmicas de Processamento Analítico Online (OLAP) para recalcular o total após um item ter sido oculto do modo de exibição. Boolean de leitura/gravação.

VisualTotalsForSets

Obtém ou define se deve incluir itens filtrados nos totais de conjuntos nomeados para a Tabela Dinâmica especificada.

Métodos

_PivotSelect(String, XlPTSelectionMode)

Reservado para uso interno.

AddDataField(Object, Object, Object)

Adiciona um campo de dados a um relatório de tabela dinâmica. Retorna um PivotField objeto que representa o novo campo de dados.

AddFields(Object, Object, Object, Object)

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 CalculatedFields coleção que representa todos os campos calculados no relatório de tabela dinâmica especificado. Somente leitura.

ChangeConnection(WorkbookConnection)

Altera a conexão do . especificado PivotTable

ChangePivotCache(Object)

Altera o PivotCache do PivotTable especificado .

ClearAllFilters()

O ClearAllFilters() método exclui todos os filtros atualmente aplicados ao PivotTable . Isso inclui a exclusão de todos os filtros na coleção do objeto, a remoção de qualquer filtragem manual aplicada e a definição de todos os s na área Filtro de Relatório para PivotFilters PivotTable o item PivotField padrão.

ClearTable()

O ClearTable() método é usado para limpar um PivotTable . A limpeza s inclui remover todos os campos e excluir toda a filtragem e PivotTable classificação aplicadas ao PivotTables . Este método redefine o estado que tinha logo após a sua criação, antes que todos os PivotTable campos fossem adicionados a ele.

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(Boolean)

O ConvertToFormulas(Boolean) método é novo no 1st_Excel12 e é usado para converter uma em PivotTable fórmulas de cubo.

CreateCubeFile(String, Object, Object, Object, Object)

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(PivotItem, Object)

Permite detalhar os dados em uma hierarquia de cubos baseada em OLAP ou PowerPivot OLAP.

DrillTo(PivotItem, CubeField, Object)

Permite que você faça uma simulação em um local dentro de uma hierarquia de cubos baseada em OLAP ou PowerPivot base.

DrillUp(PivotItem, Object, Object)

Permite que você faça o detalhamento dos dados em uma hierarquia de cubo baseada em OLAP ou PowerPivot baseada.

Dummy15(Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object)

Reservado para uso interno.

Dummy2(Object, Object, Object, Object)
Format(XlPivotFormatType)

Define um relatório de tabela dinâmica como um dos formatos predefinidos recuados, não recuados ou tabulados entre tabulações.

GetData(String)

Retorna dados da célula de tabela dinâmica especificada.

GetPivotData(Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object)

Retorna um objeto Range com informações sobre um item de dados em um relatório de tabela dinâmica.

ListFormulas()

Cria uma lista dos itens e campos calculados da tabela dinâmica em uma planilha separada.

PivotCache()

Retorna um PivotCache objeto que representa o cache do relatório de tabela dinâmica especificado. Somente leitura.

PivotFields(Object)

Retorna um objeto que representa um único campo de tabela dinâmica (um objeto) ou uma coleção de campos visíveis e ocultos (um objeto) no relatório PivotField PivotFields de tabela dinâmica. Somente leitura.

PivotSelect(String, XlPTSelectionMode, Object)

Seleciona parte de um relatório de tabela dinâmica.

PivotTableWizard(Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object)

Cria um PivotTable objeto. Este método não exibe o Assistente de Tabela Dinâmica. Esse método não está disponível para fontes de dados OLE DB. Use o método para adicionar um cache de tabela dinâmica e crie um Add(PivotCache, Object, Object, Object, Object) relatório de tabela dinâmica com base no cache.

PivotValueCell(Object, Object)

Recupere o PivotValueCell objeto de uma determinada Tabela Dinâmica, fornecendo determinados índices de linha e coluna.

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 tiver êxito.

RepeatAllLabels(XlPivotFieldRepeatLabels)

Define se os rótulos de item de repetição para todos os PivotFields na Tabela Dinâmica especificada.

RowAxisLayout(XlLayoutRowType)

Esse método é usado para definir simultaneamente opções de layout para todos os PivotField s existentes.

ShowPages(Object)

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(XlSubtototalLocationType)

Este método altera o local do subtotal para todos os PivotFields 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 link ou o relatório de tabela dinâmica.

Aplica-se a