Propriedade PivotField.IncludeNewItemsInFilter (Excel)

Permite aos desenvolvedores especificar se itens excluídos ou incluídos deverão ser controlados quando a filtragem manual for aplicada ao PivotField. Boolean de leitura/gravação.

Sintaxe

expressão. IncludeNewItemsInFilter

Expressão Uma variável que representa um objeto PivotField .

Comentários

O valor padrão para essa propriedade é False.

Quando a filtragem manual é aplicada, os desenvolvedores podem definir a propriedade IncludeNewItemsInFilter como True para rastrear itens excluídos. Eles podem definir a propriedade como False para rastrear itens incluídos. Se novos itens forem adicionados aos dados de origem após a propriedade IncludeNewItemsInFilter ser definida como True, os novos itens serão exibidos na Tabela Dinâmica após a próxima operação de atualização porque eles não estão na coleção de itens que o Excel está acompanhando.

Para hierarquias OLAP, essa configuração é definida no objeto CubeField e tentar defini-lo em PivotFields que fazem parte de uma hierarquia falhará (com um erro de tempo de execução). Você pode obter essa configuração de PivotFields que façam parte de uma hierarquia e ela retornará o mesmo que a propriedade CubeField.IncludeNewItemsInFilter correspondente.

Ativar/desativar essa configuração limpará as seguintes coleções: HiddenItemsList, HiddenItems, VisibleItemsList e VisibleItems. Quando IncludeNewItemsInFilter estiver definido como False, as coleções HiddenItemsList e HiddenItems estarão vazias e não será possível adicionar itens a elas. Um erro em tempo de execução será retornado ao tentar adicionar itens. Quando IncludeNewItemsInFilter estiver definido como True, as coleções VisibleItemsList e VisibleItems estarão vazias e não será possível adicionar itens a elas. Um erro em tempo de execução será retornado ao tentar adicionar itens.

Em Tabelas Dinâmicas, essa configuração é definida no objeto PivotField . Ativar/desativar essa configuração não mudará o estado do filtro.

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.