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 de Campo Dinâmico .

Comentários

O valor padrão para essa propriedade é False.

Quando a filtragem manual é aplicada, os programadores podem definir a propriedade IncludeNewItemsInFilter como Verdadeiro para controlar os itens excluídos. Podem definir a propriedade como Falso para controlar os itens incluídos. Se forem adicionados novos itens aos dados de origem após a propriedade IncludeNewItemsInFilter estar definida como Verdadeiro, os novos itens serão apresentados na Tabela Dinâmica após a próxima operação de atualização porque não estão na coleção de itens que o Excel está a controlar.

Para hierarquias OLAP, esta definição é definida no objeto CampoDo Cubo e tentar defini-la em Campos Dinâmicos que fazem parte de uma hierarquia irá 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, esta definição é definida no objeto Campo Dinâmico . 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.