Método Worksheet.PivotTableWizard (Excel)
Cria um novo relatório de Tabela Dinâmica. Esse método não exibe o Assistente de Tabela Dinâmica. Esse método não está disponível para fontes de dados OLE DB. Use o método Adicionar para adicionar um cache de Tabela Dinâmica e crie um relatório de Tabela Dinâmica com base no cache.
Sintaxe
expressão. PivotTableWizard (SourceType, SourceData, TableDestination, TableName, RowGrand, ColumnGrand, SaveData, HasAutoFormat, AutoPage, Reserved, BackgroundQuery, OptimizeCache, PageFieldOrder, PageFieldWrapCount, ReadData, Connection)
Expressão Uma variável que representa um objeto Worksheet .
Parâmetros
| Nome | Obrigatório/Opcional | Tipo de dados | Descrição |
|---|---|---|---|
| SourceType | Opcional | Variantes | Um valor XlPivotTableSourceType que representa a origem dos dados do relatório. Se você especificar este argumento, deverá especificar também SourceData. Se SourceType e SourceData forem omitidos, o Microsoft Excel assumirá que o tipo de origem é xlDatabase e os dados de origem serão provenientes do banco de dados de intervalo nomeado. Se esse intervalo nomeado não existir, o Excel usará a região atual se a seleção atual estiver em um intervalo de mais de 10 células que contêm dados. Se isso não for verdade, esse método falhará. |
| SourceData | Opcional | Variantes | Os dados para o novo relatório. Pode ser um objeto Range , uma matriz de intervalos ou uma constante de texto que representa o nome de outro relatório. Em um banco de dados externo, SourceData é uma matriz de sequências que contêm a sequência de consulta SQL, na qual cada elemento tem no máximo 255 caracteres. Você deve usar o argumento Connection para especificar a sequência de conexão ODBC. Para obter compatibilidade com as versões anteriores do Excel, SourceData pode ser uma matriz de dois elementos. O primeiro elemento é a sequência de conexão que especifica a fonte ODBC referente aos dados. O segundo elemento é a sequência de consulta SQL usada para obter os dados. Se você especificar o argumento SourceData, deverá especificar também SourceType. Se a célula ativa estiver dentro do intervalo SourceData, também será preciso especificar TableDestination. |
| TableDestination | Opcional | Variantes | Um objeto Range que especifica onde o relatório deve ser inserido na planilha. Se este argumento for omitido, o relatório será inserido na célula ativa. |
| TableName | Opcional | Variantes | Uma sequência de caracteres especificando o nome do novo relatório. |
| RowGrand | Opcional | Variantes | True para exibir totais para linhas no relatório. |
| ColumnGrand | Opcional | Variantes | True para exibir totais para colunas do relatório. |
| SaveData | Opcional | Variantes | True para salvar dados com o relatório. False para salvar apenas a definição do relatório. |
| HasAutoFormat | Opcional | Variantes | True para que o Excel formate automaticamente o relatório quando ele é atualizado ou quando os campos são movidos. |
| Autopage | Opcional | Variantes | Válido somente se SourceType for xlConsolidation. True para que o Excel crie um campo de página para a consolidação. Se AutoPage for False, você precisará criar o(s) campo(s) de página. |
| Reserved | Opcional | Variantes | Não usado pelo Excel. |
| BackgroundQuery | Opcional | Variantes | True para que o Excel faça consultas ao relatório de forma assíncrona (no segundo plano). O valor padrão é False. |
| OptimizeCache | Opcional | Variantes | True para otimizar o cache de tabela dinâmica quando ela for construída. O valor padrão é False. |
| PageFieldOrder | Opcional | Variantes | A ordem na qual os campos de página são adicionados ao layout do relatório de Tabela Dinâmica. Pode ser uma das seguintes constantes XlOrder : xlDownThenOver (padrão) ou xlOverThenDown. |
| PageFieldWrapCount | Opcional | Variantes | O número de campos de página em cada coluna ou linha no relatório de tabela dinâmica. O valor padrão é 0 (zero). |
| Readdata | Opcional | Variantes | True para criar um cache de tabela dinâmica que contenha todos os registros do banco de dados externo; este cache pode ser muito grande. Se ReadData for False, você poderá definir alguns dos campos como campos de página baseados em servidor antes que os dados sejam realmente lidos. |
| Connection | Opcional | Variantes | Uma sequência que contém configurações de ODBC que permitem ao Excel conectar-se a uma fonte de dados ODBC. A cadeia de conexão tem o formulário ODBC;<connection string>. Esse argumento substitui qualquer configuração anterior para a propriedade Connection do objeto PivotCache. |
Valor de retorno
Um objeto de Tabela Dinâmica que representa o novo relatório de Tabela Dinâmica.
Exemplo
Este exemplo cria um novo relatório de Tabela Dinâmica de um banco de dados do Excel (contido no intervalo A1:C100).
ActiveSheet.PivotTableWizard xlDatabase, Range("A1:C100")
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.