Range.Group(Object, Object, Object, Object) Método

Definição

Namespace:

Microsoft.Office.Interop.Excel

Assembly:

Microsoft.Office.Interop.Excel.dll

Quando o Range objeto representa uma única célula no intervalo de dados de um campo de Tabela Dinâmica, o método Group executa agrupamento numérico ou baseado em datas nesse campo.

public object Group (object Start, object End, object By, object Periods);

Public Function Group (Optional Start As Object, Optional End As Object, Optional By As Object, Optional Periods As Object) As Object

Parâmetros

Start

Object

Objeto opcional. O primeiro valor a ser agrupado. Se este argumento for omitido ou for True, será usado o primeiro valor no campo.

End

Object

Objeto opcional. O último valor a ser agrupado. Se este argumento for omitido ou for True, será usado o último valor no campo.

By

Object

Objeto opcional. Se o campo for numérico, este argumento especificará o tamanho de cada grupo. Se o campo for uma data, esse argumento especifica o número de dias em cada grupo se o Periods elemento 4 na matriz for True e todos os outros elementos forem False. Caso contrário, este argumento será ignorado. Se esse argumento for omitido, o Microsoft Excel escolherá automaticamente um tamanho de grupo padrão.

Periods

Object

Objeto opcional. Uma matriz de valores boolianos que especificam o período para o grupo, conforme mostrado na tabela a seguir. Se um elemento na matriz for True, um grupo será criado para o tempo correspondente; se o elemento for False, nenhum grupo será criado. Se o campo não for um campo de data, este argumento será ignorado.

Retornos

Object

Comentários

O objeto Range deve ser uma única célula no intervalo de dados do campo de tabela dinâmica. Se você tentar aplicar esse método a mais de uma célula, ele falhará, mas não exibirá uma mensagem de erro.