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.

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 depois que a propriedade IncludeNewItemsInFilter for definida como true, os novos itens aparecerão 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á controlando. Para hierarquias OLAP, essa configuração é definida no objeto CubeField e tentar defini-la no PivotFields que fazem parte de uma hierarquia falharão (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.


ActiveCell.PivotField.IncludeNewItemsInFilter = True