PivotField Interface

Definição

Namespace:

Microsoft.Office.Interop.Excel

Assembly:

Microsoft.Office.Interop.Excel.dll

Representa um campo em um relatório de tabela dinâmica. O objeto PivotField é um membro da PivotFields coleção. A coleção PivotFields contém todos os campos em um relatório de tabela dinâmica, inclusive campos ocultos.

public interface class PivotField

[System.Runtime.InteropServices.Guid("00020874-0000-0000-C000-000000000046")]
[System.Runtime.InteropServices.InterfaceType(2)]
public interface PivotField

Public Interface PivotField

Atributos

GuidAttribute InterfaceTypeAttribute

Comentários

Use PivotFields(index), onde index é o nome do campo ou o número do índice, para retornar um único objeto PivotField .

Em alguns casos, pode ser mais fácil usar uma das propriedades do que retornar um subconjunto dos campos da tabela dinâmica. Estas propriedades estão disponíveis:

• CubeFields Propriedade
• DataFields[Object] Propriedade
• HiddenFields[Object] Propriedade
• PageFields[Object] Propriedade
• RowFields[Object] Propriedade
• VisibleFields[Object] Propriedade

Propriedades

_Default	Reservado para uso interno.
AllItemsVisible	Recupera um valor que indica se qualquer filtragem manual é ou não aplicada ao Microsoft.Office.Interop.Excel.Pivotfield. Somente leitura.
Application	Retorna um _Application objeto que representa o aplicativo Microsoft Excel. Somente leitura.
AutoShowCount	Retorna o número de itens superiores ou inferiores que são automaticamente mostrados no campo de tabela dinâmica especificado. Integer somente leitura.
AutoShowField	Retorna o nome do campo de dados usado para determinar os itens superiores ou inferiores que são automaticamente mostrados no campo de tabela dinâmica especificado. String somente leitura.
AutoShowRange	Retorna xlTop se os primeiros itens forem mostrados automaticamente no campo Tabela dinâmica especificado; retorna xlBottom se os últimos itens forem mostrados. Integer somente leitura.
AutoShowType	Retorna xlAutomatic se AutoShow(Int32, Int32, Int32, String) estiver habilitado para o campo de Tabela Dinâmica especificado; retornará xlManual se o AutoShow estiver desabilitado . Integer somente leitura.
AutoSortCustomSubtotal	Retorna um inteiro correspondente ao subtotal personalizado usado para classificar o campo especificado PivotTable automaticamente. Somente leitura.
AutoSortField	Retorna o nome do campo de dados usado para classificar automaticamente o campo de tabela dinâmica especificado. String somente leitura.
AutoSortOrder	Retorna a ordem usada para classificar automaticamente o campo de tabela dinâmica especificado. Pode ser uma das XlSortOrder constantes. Integer somente leitura.
AutoSortPivotLine	Retorna o PivotLine usado para classificar o campo especificado PivotTable automaticamente. Somente leitura.
BaseField	Retorna ou define o campo base para um cálculo personalizado. Essa propriedade é válida somente para campos de dados. Objeto de leitura/gravação.
BaseItem	Retorna ou define o item do campo base para um cálculo personalizado. Válido somente para campos de dados. Objeto de leitura/gravação.
Calculation	Retorna ou define o tipo de cálculo executado pelo campo especificado. Esta propriedade é válida somente para campos de dados. Leitura/gravação XlPivotFieldCalculation.
Caption	O texto do rótulo para o campo dinâmico. String somente leitura.
ChildField	Retorna um PivotField objeto que representa o campo filho para o campo especificado (se o campo estiver agrupado e tiver um campo filho). Somente leitura.
ChildItems[Object]	Retorna um objeto que representa um único item de Tabela Dinâmica (um PivotItem objeto) ou uma coleção de todos os itens (um PivotItems objeto) que são crianças de grupo no campo especificado ou filhos do item especificado. Somente leitura.
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 XlCreatorleitura .
CubeField	Retorna o CubeField objeto do qual o campo de Tabela Dinâmica especificado é descido. Somente leitura.
CurrentPage	Retorna ou define a página sendo atualmente exibida para o campo de página (válida somente para campos de página). Objeto de leitura/gravação.
CurrentPageList	Retorna ou define uma matriz de cadeia de caracteres que correspondem à lista de itens incluídos em um campo de página de um relatório de tabela dinâmica. Objeto de leitura/gravação.
CurrentPageName	Retorna ou define a página atualmente exibida do relatório de tabela dinâmica especificado. O nome da página é exibido no campo da página. Observe que essa propriedade funciona somente se a página atualmente exibida já existir. String de leitura/gravação.
DatabaseSort	Quando definido como True, o reposicionamento manual de itens em um campo da tabela dinâmica é permitido. Retorna True se o campo não tiver itens posicionados manualmente. Boolean de leitura/gravação.
DataRange	Retorna um Range objeto. Somente leitura.
DataType	Retorna uma constante que descreve o tipo de dados no campo Tabela Dinâmica. Somente XlPivotFieldDataTypeleitura .
DisplayAsCaption	Essa propriedade é usada para exibir propriedades membro de PivotFields como legendas. Somente leitura.
DisplayAsTooltip	Essa propriedade é usada para especificar se uma propriedade PivotField membro específica é exibida ou não em dicas de ferramentas. Leitura/gravação.
DisplayInReport	Essa propriedade é usada para especificar se a propriedade PivotField membro especificada é exibida no PivotTable ou não. Leitura/gravação.
DragToColumn	True se o campo especificado puder ser arrastado para a posição de coluna. O valor padrão é True. Boolean de leitura/gravação.
DragToData	True se o campo especificado puder ser arrastado para a posição de dados. O valor padrão é True. Boolean de leitura/gravação.
DragToHide	True se o campo puder ser ocultado sendo arrastado para fora do relatório de tabela dinâmica. O valor padrão é True. Boolean de leitura/gravação.
DragToPage	True se o campo puder ser arrastado para a posição de página. O valor padrão é True. Boolean de leitura/gravação.
DragToRow	True se o campo puder ser arrastado para a posição de linha. O valor padrão é True. Boolean de leitura/gravação.
DrilledDown	True se o sinalizador para o campo ou item de tabela dinâmica especificado estiver definido como "esburacado" (expandido ou visível). Boolean de leitura/gravação.
EnableItemSelection	Quando estiver definido como False, desativa a capacidade de usar o campo suspenso na interface do usuário. O valor padrão é True. Boolean de leitura/gravação.
EnableMultiplePageItems	Usada para especificar se haverá ou não caixas de diálogo na lista suspensa de filtro dos campos na área da página. Leitura/gravação.
Formula	Retorna ou define a fórmula do objeto na cadeia de caracteres de leitura /gravação no estilo A1.
Function	Retorna ou define a função usada para resumir o campo da tabela dinâmica (somente para campos de dados). Leitura/gravação XlConsolidationFunction.
GroupLevel	Retorna o posicionamento do campo especificado dentro de um grupo de campos (se o campo for um membro de um conjunto agrupado de campos). Somente leitura.
Hidden	Propriedade usada para ocultar níveis individuais de uma hierarquia OLAP. Leitura/gravação.
HiddenItems[Object]	Retorna um objeto que representa um único item de Tabela Dinâmica oculto (um PivotItem objeto) ou uma coleção de todos os itens ocultos (um PivotItems objeto) no campo especificado. Somente leitura.
HiddenItemsList	Retorna ou define um objeto que especifica uma matriz de cadeias de caracteres que são itens ocultos para um campo de Tabela Dinâmica. Leitura/gravação.
IncludeNewItemsInFilter	Permite que os desenvolvedores especifiquem se itens excluídos ou incluídos devem ser rastreados quando a filtragem manual é aplicada ao PivotField. Leitura/gravação.
IsCalculated	True se o campo Tabela Dinâmica ou item de Tabela Dinâmica for um campo ou item calculado. Boolean somente leitura.
IsMemberProperty	Retorna True quando a tabela dinâmica contiver propriedades de membro. Boolean somente leitura.
LabelRange	Para um PivotField objeto, retorna um Range objeto que representa a célula (ou células) que contêm o rótulo de campo. Para um PivotItem objeto, retorna um objeto Range que representa todas as células no relatório tabela dinâmica que contêm o item. Somente leitura.
LayoutBlankLine	True se uma linha em branco for inserida após o campo de linha especificado em um relatório de tabela dinâmica. O valor padrão é False. Boolean de leitura/gravação.
LayoutCompactRow	Especifica se um PivotField é compactado ou não (itens de vários PivotFields são exibidos em uma única coluna) quando as linhas são selecionadas. Leitura/gravação.
LayoutForm	Retorna ou define a maneira como os itens de Tabela Dinâmica especificados aparecem – no formato de tabela ou no formato de contorno. Leitura/gravação XlLayoutFormType.
LayoutPageBreak	True se uma quebra de página for inserida após cada campo. O valor padrão é False. Boolean de leitura/gravação.
LayoutSubtotalLocation	Retorna ou define a posição dos subtotais do campo de tabela dinâmica em relação ao campo especificado (acima ou abaixo). Leitura/gravação XlSubtototalLocationType.
MemberPropertyCaption	Definir os controles de MemberPropertyCaption propriedade qual propriedade membro é usada como legenda para um determinado nível. Leitura/gravação.
MemoryUsed	Retorna a quantidade de memória em bytes que estão sendo usados atualmente pelo objeto. Integer somente leitura.
Name	Retorna ou define o nome do objeto. String de leitura/gravação.
NumberFormat	Retorna ou define o código de formatação para o objeto. String de leitura/gravação.
Orientation	O local do campo no relatório de Tabela Dinâmica especificado. Leitura/gravação XlPivotFieldOrientation.
Parent	Retorna o objeto pai do objeto especificado. Somente leitura.
ParentField	Retorna um PivotField objeto que representa o campo Tabela Dinâmica que é o pai do grupo do objeto especificado. O campo deve ser agrupado e possuir um campo pai. Somente leitura.
ParentItems[Object]	Retorna um objeto que representa um único item de Tabela Dinâmica (um PivotItem objeto) ou uma coleção de todos os itens (um PivotItems objeto) que são pais de grupo no campo especificado. O campo especificado precisa ser um pai de grupo de outro campo. Somente leitura.
PivotFilters	Retorna ou define o PivotFilters para o objeto especificado PivotField . Somente leitura.
Position	Posição do campo (primeiro, segundo, terceiro e assim por diante) entre todos os campos em sua orientação (Linhas, Colunas, Páginas, Dados). Objeto de leitura/gravação.
PropertyOrder	Válida somente para campos de tabela dinâmica que são campos de propriedades membros. Retorna um Inteiro indicando a posição de exibição da propriedade membro dentro do campo cubo ao qual ele pertence. Leitura/gravação.
PropertyParentField	Retorna um PivotField objeto que representa o campo ao qual as propriedades neste campo pertencem.
RepeatLabels	Obtém ou define se os rótulos de item são repetidos na Tabela Dinâmica para o PivotField especificado.
ServerBased	True se a fonte de dados para o relatório de tabela dinâmica especificado for externa e apenas os itens correspondentes à seleção de campo de página forem recuperados. Boolean de leitura/gravação.
ShowAllItems	True se todos os itens do relatório de Tabela Dinâmica forem exibidos, mesmo que não contenham dados de resumo. O valor padrão é False. Boolean de leitura/gravação.
ShowDetail	Obtém ou define se o especificado PivotField está mostrando detalhes. Leitura/gravação.
ShowingInAxis	Indica se o PivotField está atualmente visível no PivotTable ou não. Somente leitura.
SourceCaption	A SourceCaption propriedade é aplicável apenas para OLAP PivotTables e retorna o legenda original do servidor OLAP para um PivotField. Somente leitura.
SourceName	Retorna o nome do objeto especificado conforme ele aparece nos dados de origem originais do relatório de Tabela Dinâmica especificado. Isso pode ser diferente do nome do item atual se o usuário renomear o item depois de criar o relatório tabela dinâmica. String somente leitura.
StandardFormula	Retorna ou define um String que especifica fórmulas com a formatação em inglês (EUA) padrão. Leitura/gravação.
SubtotalName	Retorna ou define o rótulo de cadeia de texto exibido no título de coluna ou linha subtotal no relatório de tabela dinâmica especificado. O valor padrão é a cadeia "Subtotal". String de leitura/gravação.
Subtotals[Object]	Retorna ou define subtotais exibidos com o campo especificado. Válido somente para campos que não são dados. Objeto de leitura/gravação.
TotalLevels	Retorna o número total de campos no grupo de campo atual. Se o campo não estiver agrupado ou se a fonte de dados for baseada em OLAP, TotalLevels retornará o valor 1. Integer somente leitura.
UseMemberPropertyAsCaption	Essa propriedade é usada para controlar se as legendas de propriedade membro são usadas para PivotItem legendas do PivotField. Leitura/gravação.
Value	O nome do campo especificado no relatório tabela dinâmica. String de leitura/gravação.
VisibleItems[Object]	Retorna um objeto que representa um único item de Tabela Dinâmica visível (um PivotItem objeto) ou uma coleção de todos os itens visíveis (um PivotItems objeto) no campo especificado. Somente leitura.
VisibleItemsList	Retorna ou define um objeto que especifica uma matriz de cadeias de caracteres que representam itens incluídos em um filtro manual aplicado a um PivotField. Leitura/gravação.

Métodos

AddPageItem(String, Object)	Adiciona outro item a um campo de página com vários itens.
AutoShow(Int32, Int32, Int32, String)	Exibe o número de itens superiores ou inferiores para um campo de coluna, página ou linha no relatório de tabela dinâmica especificado.
AutoSort(Int32, String)	Estabelece regras automáticas de classificação de campos para relatórios da tabela dinâmica.
AutoSortEx(Int32, String, Object, Object)	Representa um campo em um relatório de tabela dinâmica. O objeto PivotField é um membro da PivotFields coleção. A coleção PivotFields contém todos os campos em um relatório de tabela dinâmica, inclusive campos ocultos.
CalculatedItems()	Retorna uma CalculatedItems coleção que representa todos os itens calculados no relatório de Tabela Dinâmica especificado. Somente leitura.
ClearAllFilters()	Chamar esse método exclui todos os filtros atualmente aplicados ao PivotField. Isso inclui excluir todos os filtros da PivotFilters coleção do PivotField e remover qualquer filtragem manual aplicada ao PivotField também. Se o PivotField estiver na área Filtro de Relatório, o item selecionado será definido como o item padrão.
ClearLabelFilters()	Esse método exclui todos os filtros de rótulo ou todos os filtros de data na PivotFilters coleção do PivotField.
ClearManualFilter()	Fornece uma maneira fácil de definir a propriedade Visible como True para todos os itens de um PivotField no PivotTablese esvaziar as coleções HiddenItemsList e VisibleItemsList no OLAP PivotTables.
ClearValueFilters()	Chamar esse método exclui todos os filtros de valor na PivotFilters coleção do PivotField.
Delete()	Exclui o objeto.
DrillTo(String)	O método DrillTo dá suporte à perfuração em um especificado PivotField de outro PivotField.
PivotItems(Object)	Retorna um objeto que representa um único item de Tabela Dinâmica (um PivotItem objeto) ou uma coleção de todos os itens visíveis e ocultos (um PivotItems objeto) no campo especificado. Somente leitura.