Classe PivotCaches - a coleção de caches de memória dos relatórios de tabela dinâmica em uma pasta de trabalho (Excel VBA)
A classe PivotCaches representa a coleção de caches de memória dos relatórios de tabela dinâmica em uma pasta de trabalho. Para usar uma variável de classe PivotCaches, ela primeiro precisa ser instanciada por exemplo
Dim pcs as PivotCaches
Set pcs = ActiveWorkbook.PivotCaches()
For Each
Aqui está um exemplo de processamento dos itens PivotCaches em uma coleção.
Dim pvtcac As PivotCache
For Each pvtcac In ActiveWorkbook.PivotCaches()
Next pvtcac
Count
Retorna um valor Long que representa o número de objetos na coleção.
Dim lngCount As Long
lngCount = ActiveWorkbook.PivotCaches.Count
Create
Cria um novo PivotCache.
As duas constantes XlPivotTableSourceType a seguir não são suportadas ao criar um PivotCache usando este método: xlPivotTable e xlScenario. Um erro em tempo de execução será retornado se uma dessas duas constantes for fornecida. O argumento SourceData será requerido se SourceType não for xlExternal. Deve ser passado um objeto Range (quando SourceType é xlConsolidation ou xlDatabase) ou um objeto WorkbookConnection (quando SourceType é xlExternal). Ao transmitir um objeto Range , recomendamos que você use uma cadeia de caracteres para especificar a pasta de trabalho, a planilha e o intervalo de células, ou configurar um intervalo nomeado e passar o nome como uma cadeia de caracteres. Passar um objeto Range pode causar erros de "incompatibilidade de tipo" inesperadamente. Quando não for fornecido, a versão da tabela dinâmica será xlPivotTableVersion12. O uso da constante xlPivotTableVersionCurrent não é permitido e retorna um erro em tempo de execução se for fornecida.
Create (SourceType, SourceData, Version)
Dim pvtcacCreate As PivotCache
Set pvtcacCreate = ActiveWorkbook.PivotCaches.Create(SourceType:=xlConsolidation)
Arguments
O seguinte argumento é necessário
SourceType (XlPivotTableSourceType) - SourceType pode ser uma destas constantes XlPivotTableSourceType : xlConsolidation, xlDatabaseou xlExternal.
Os valores possíveis são
xlConsolidation | Vários intervalos de consolidação. |
xlDatabase | Banco de dados ou lista do Microsoft Excel. |
xlExternal | Dados de um outro aplicativo. |
xlPivotTable | Mesma fonte que a de um outro relatório de tabela dinâmica. |
xlScenario | Dados baseados em cenários criados com o Gerenciador de Cenários. |
Optional arguments
Os seguintes argumentos são opcionais
SourceData - Os dados para o novo cache da tabela dinâmica
Version (XlPivotTableVersionList) - Versão da tabela dinâmica. Version pode ser uma das constantes XlPivotTableVersionList .
Os valores possíveis são
xlPivotTableVersion10 | Excel 2002Excel 2002 |
xlPivotTableVersion11 | Excel 2003Excel 2003 |
xlPivotTableVersion12 | Excel 2007Excel 2007 |
xlPivotTableVersion14 | Excel 2010Excel 2010 |
xlPivotTableVersion15 | Excel 2013Excel 2013 |
xlPivotTableVersion2000 | Excel 2000Excel 2000 |
xlPivotTableVersionCurrent | Fornecido apenas para compatibilidade com versões anteriores |
Item
Retorna um único objeto de uma coleção.
Item (Index)
Index: O nome ou número de índice do objeto.
Dim pvtcac As PivotCache
Set pvtcac = ActiveWorkbook.PivotCaches(Index:=1)