Ler em inglês

Compartilhar via


Método Slicers.Add (Excel)

Cria uma nova segmentação e retorna um objeto Slicer .

Sintaxe

expressão. Adicionar (SlicerDestination, Level, Name, Caption, Top, Left, Width, Height)

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

Parâmetros

Nome Obrigatório/Opcional Tipo de dados Descrição
SlicerDestination Obrigatório Variantes Uma Cadeia de Caracteres que especifica o nome da planilha ou um objeto Worksheet que representa a planilha, em que a segmentação resultante será colocada. A folha de destino deve estar na pasta de trabalho que contém o objeto Slicers especificado pela expressão.
Nível Opcional Variantes Em fontes de dados OLAP, o nome do ordinal ou da expressão MDX do nível no qual se baseia a criação da segmentação de dados. Não há suporte para fontes de dados que não sejam OLAP.
Name Opcional Variantes O nome da segmentação de dados. O Excel gera automaticamente um nome, caso não haja um especificado. O nome deve ser único em todas as segmentações de dados de uma pasta de trabalho.
Caption Opcional Variantes Legenda da segmentação de dados.
Top Opcional Variantes A posição vertical inicial da segmentação, em pontos, em relação ao canto superior esquerdo da célula A1 em uma planilha.
Left Opcional Variantes A posição horizontal inicial da segmentação de dados, em pontos, em relação ao canto superior esquerdo da célula A1 de uma planilha.
Width Opcional Variantes A largura inicial, em pontos, do controle da segmentação de dados.
Height Opcional Variantes A altura inicial, em pontos, do controle da segmentação de dados.

Valor de retorno

Segmentação de dados

Exemplo

Este exemplo adiciona um objeto SlicerCache usando a fonte de dados OLAP AdventureWorks e adiciona um objeto Slicer para filtrar no campo País.

Sub CreateNewSlicer() 
 ActiveWorkbook.SlicerCaches.Add("Adventure Works", _ 
 "[Customer].[Customer Geography]").Slicers.Add ActiveSheet, _ 
 "[Customer].[Customer Geography].[Country]", "Country 1", "Country", _ 
 252, 522, 144, 216) 
End Sub

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.