PivotField Interface
Definição
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
Comentários
Use PivotFields( ), onde está o nome do campo ou número index de index í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 property
- DataFields[Object] property
- HiddenFields[Object] property
- PageFields[Object] property
- RowFields[Object] property
- VisibleFields[Object] property
Propriedades
| _Default |
Reservado para uso interno. |
| AllItemsVisible |
Recupera um valor que indica se qualquer filtragem manual é aplicada ou não ao Microsoft.Office.Interop.Excel.Pivotfield . Somente leitura. |
| Application |
Retorna um _Application objeto que representa o Microsoft Excel aplicativo. 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 de leitura/gravação. |
| 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 estiver habilitado para o campo tabela dinâmica AutoShow(Int32, Int32, Int32, String) especificado; retornará xlManual se o AutoShow estiver desabilitado. Integer somente leitura. |
| AutoSortCustomSubtotal |
Retorna um inteiro correspondente ao subtotal personalizado usado para classificar o campo PivotTable especificado automaticamente. Somente leitura. |
| AutoSortField |
Retorna o nome do campo de dados usado para classificar automaticamente o campo de tabela dinâmica especificado. String de leitura/gravação |
| 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. XlPivotFieldCalculationLeitura/gravação. |
| Caption |
O texto do rótulo do campo pivô. String somente leitura. |
| ChildField |
Retorna um objeto que representa o campo filho do campo especificado (se o campo for PivotField agrupado e tiver um campo filho). Somente leitura. |
| ChildItems[Object] |
Retorna um objeto que representa um único item de tabela dinâmica (um objeto) ou uma coleção de todos os itens (um objeto) que são filhos de grupo no campo especificado ou filhos do PivotItem PivotItems 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 objeto do qual o campo tabela dinâmica CubeField 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 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 leitura XlPivotFieldDataType . |
| DisplayAsCaption |
Essa propriedade é usada para exibir propriedades de membros PivotField de s como legendas. Somente leitura. |
| DisplayAsTooltip |
Essa propriedade é usada para especificar se uma propriedade membro específica é exibida ou não PivotField em dicas de ferramentas. Leitura/gravação. |
| DisplayInReport |
Essa propriedade é usada para especificar se a propriedade membro especificada PivotField é exibida no ou PivotTable 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. Leitura/gravação booleano. |
| 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 em A1-style notation 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). XlConsolidationFunctionLeitura/gravação. |
| 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 objeto) ou uma coleção de todos os itens ocultos PivotItem (um PivotItems objeto) no campo especificado. Somente leitura. |
| HiddenItemsList |
Retorna ou define um Object especificando 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 os itens excluídos ou incluídos devem ser rastreados quando a filtragem manual é aplicada ao PivotField . Leitura/gravação. |
| IsCalculated |
True se o campo de 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 de somente leitura |
| LabelRange |
Para um PivotField objeto, retorna um objeto que representa a Range célula (ou células) que contém o rótulo de campo. Para um objeto, retorna um objeto Range que representa todas as células no relatório PivotItem 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 um é compactado ou não (itens de vários s são exibidos em uma única PivotField PivotField coluna) quando as linhas são selecionadas. Leitura/gravação. |
| LayoutForm |
Retorna ou define a forma como os itens de tabela dinâmica especificados aparecem — no formato de tabela ou no formato de contorno. XlLayoutFormTypeLeitura/gravação. |
| 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). XlSubtototalLocationTypeLeitura/gravação. |
| MemberPropertyCaption |
Definir os MemberPropertyCaption controles de propriedade que a propriedade membro é usada como legenda para um determinado nível. Leitura/gravação. |
| MemoryUsed |
Retorna a quantidade de memória em bytes atualmente sendo usados 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. Cadeia de caracteres de leitura/gravação. |
| Orientation |
O local do campo no relatório de tabela dinâmica especificado. XlPivotFieldOrientationLeitura/gravação. |
| Parent |
Retorna o objeto pai para o objeto especificado. Somente leitura. |
| ParentField |
Retorna um objeto que representa o campo Tabela Dinâmica que é o pai PivotField 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 objeto) ou uma coleção de todos os itens (um objeto) que são pais de grupo no PivotItem PivotItems campo especificado. O campo especificado precisa ser um pai de grupo de outro campo. Somente leitura. |
| PivotFilters |
Retorna ou define PivotFilters o para o objeto PivotField especificado. 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 membro dentro do campo de cubo ao qual 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 do 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 está visível no momento PivotField PivotTable ou não. Somente leitura. |
| SourceCaption |
A propriedade é aplicável apenas para OLAP e retorna a legenda original do servidor SourceCaption PivotTable OLAP para PivotField um . 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 pode ser diferente do nome do item atual se o usuário renomear o item após a criação do 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 somente para campos que não são 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 |
Essa propriedade é usada para controlar se as legendas da propriedade membro são usadas para PivotItem legendas do PivotField . 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 de tabela dinâmica visível (um objeto) ou uma coleção de todos os itens visíveis PivotItem (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 PivotField um . 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) | |
| 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 a exclusão de todos os filtros da coleção do e a remoção de qualquer filtragem PivotFilters PivotField manual aplicada ao PivotField também. Se o estiver na área Filtro de Relatório, o item selecionado PivotField será definido como o item padrão. |
| ClearLabelFilters() |
Este método exclui todos os filtros de rótulo ou todos os filtros de data na PivotFilters coleção PivotField do . |
| ClearManualFilter() |
Fornece uma maneira fácil de definir a propriedade Visible como True para todos os itens de um em e esvaziar as coleções PivotField PivotTables HiddenItemsList e VisibleItemsList em OLAP PivotTables . |
| ClearValueFilters() |
Chamar esse método exclui todos os filtros de valor PivotFilters na coleção PivotField do . |
| Delete() |
Exclui o objeto. |
| DrillTo(String) |
O método DrillTo dá suporte à furação para um especificado PivotField de outro PivotField . |
| PivotItems(Object) |
Retorna um objeto que representa um único item de tabela dinâmica (um objeto) ou uma coleção de todos os itens visíveis e ocultos PivotItem (um PivotItems objeto) no campo especificado. Somente leitura. |