PivotField Interface

Definição

Namespace:: Microsoft.Office.Interop.Excel

Assembly:: Microsoft.Office.Interop.Excel.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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 de propriedade
DataFields[Object] de propriedade
HiddenFields[Object] de propriedade
PageFields[Object] de propriedade
RowFields[Object] de propriedade
VisibleFields[Object] de propriedade

Propriedades

Nome	Description
_Default	Reservado para uso interno.
AllItemsVisible	Recupera um valor que indica se uma filtragem manual é aplicada ou não ao Microsoft.Office.Interop.Excel.Pivotfieldarquivo . Somente leitura.
Application	Retorna um _Application objeto que representa o aplicativo do 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; retorna xlManual se o AutoShow estiver desabilitado. Integer somente leitura.
AutoSortCustomSubtotal	Retorna um número 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 realizado 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 do campo especificado (se o campo estiver agrupado e tiver um campo filho). Somente leitura.
ChildItems[Object]	Retorna um objeto que representa um único item da Tabela Dinâmica (um PivotItem objeto) ou um conjunto de todos os itens (um PivotItems objeto) que são filhos do 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 leitura XlCreator.
CubeField	Retorna o CubeField objeto do qual o campo de Tabela Dinâmica especificado é descendente. 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 Verdadeiro se o campo não possui 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 da Tabela Dinâmica. Somente leitura XlPivotFieldDataType.
DisplayAsCaption	Esta propriedade é usada para exibir propriedades de membro de PivotFields como legendas. Somente leitura.
DisplayAsTooltip	Essa propriedade é usada para especificar se uma propriedade PivotField de membro específica é exibida ou não nas dicas de ferramentas. Leitura/gravação.
DisplayInReport	Esta propriedade é usada para especificar se a PivotTable propriedade PivotField do membro especificado é exibida no 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 notação estilo A1 Cadeia de caracteres de leitura/gravação.
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 oculto da Tabela Dinâmica (um PivotItem objeto) ou um conjunto de todos os itens ocultos (um PivotItems objeto) no campo especificado. Somente leitura.
HiddenItemsList	Retorna ou define um Objeto especificando uma matriz de cadeias de caracteres que são itens ocultos para um campo da Tabela Dinâmica. Leitura/gravação.
IncludeNewItemsInFilter	Permite que os desenvolvedores especifiquem se os itens excluídos ou incluídos devem ser rastreados quando a filtragem manual é aplicada ao PivotField. Leitura/gravação.
IsCalculated	Verdadeiro se o campo Tabela Dinâmica ou item da 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 do campo. Para um PivotItem objeto, retorna um objeto Intervalo que representa todas as células no relatório de 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 a 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 aparência dos itens especificados da Tabela Dinâmica, em formato de tabela ou em formato de estrutura de tópicos. 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	A configuração da propriedade controla MemberPropertyCaption qual propriedade de membro é usada como legenda para um determinado nível. Leitura/gravação.
MemoryUsed	Retorna a quantidade de memória em bytes que está sendo usada 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 da Tabela Dinâmica que é o grupo pai 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 da Tabela Dinâmica (um PivotItem objeto) ou um conjunto de todos os itens (um PivotItems objeto) que são pais do 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 Integer indicando a posição de exibição da propriedade do membro dentro do campo de cubo ao qual ela pertence. Leitura/gravação.
PropertyParentField	Retorna um PivotField objeto que representa o campo ao qual as propriedades desse campo pertencem.
RepeatLabels	Obtém ou define se os rótulos de item são repetidos na Tabela Dinâmica para o Campo Dinâmico 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á visível no PivotTable momento ou não. Somente leitura.
SourceCaption	A SourceCaption propriedade é aplicável somente para OLAP PivotTables e retorna a legenda original do servidor OLAP para um PivotField. Somente leitura.
SourceName	Retorna o nome do objeto especificado como ele aparece nos dados de origem originais do relatório de Tabela Dinâmica especificado. Isso poderá ser diferente do nome do item atual se o usuário renomear o item depois de criar o relatório de 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 apenas para campos que não sejam de 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	Esta propriedade é usada para controlar se as PivotFieldlegendas da propriedade do membro são usadas para PivotItem legendas do . Leitura/gravação.
Value	O nome do campo especificado no relatório de tabela dinâmica. String de leitura/gravação.
VisibleItems[Object]	Retorna um objeto que representa um único item visível da Tabela Dinâmica (um PivotItem objeto) ou um conjunto de todos os itens visíveis (um PivotItems objeto) no campo especificado. Somente leitura.
VisibleItemsList	Retorna ou define um Object especificando uma matriz de cadeias de caracteres que representam itens incluídos em um filtro manual aplicado a um PivotFieldarquivo . Leitura/gravação.

Métodos

Nome	Description
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 PivotFilters todos os filtros da coleção do PivotField e remover qualquer filtragem manual aplicada ao PivotField também. Se estiver PivotField 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 em PivotTablese esvaziar as coleções HiddenItemsList e VisibleItemsList em 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 para um especificado PivotField de outro PivotField.
PivotItems(Object)	Retorna um objeto que representa um único item da Tabela Dinâmica (um PivotItem objeto) ou um conjunto de todos os itens visíveis e ocultos (um PivotItems objeto) no campo especificado. Somente leitura.

Aplica-se a

Comentários

Esta página foi útil?