Método Range.Group (Excel)
Quando o objeto Range 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.
expressão. Grupo (Iniciar, Terminar, Por, Períodos)
expressão Uma variável que representa um objeto de Intervalo.
Nome | Obrigatório/Opcional | Tipo de dados | Descrição |
---|---|---|---|
Start | Opcional | Variantes | O primeiro valor a ser agrupado. Se este argumento for omitido ou for True, será usado o primeiro valor no campo. |
End | Opcional | Variantes | O último valor a ser agrupado. Se este argumento for omitido ou for True, será usado o último valor no campo. |
By | Opcional | Variantes | Se o campo for numérico, este argumento especificará o tamanho de cada grupo. Se o campo for uma data, este argumento especificará o número de dias em cada grupo se o elemento 4 da matriz Periods 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 | Opcional | Variantes | Uma matriz de valores Boolean que especifica o período do grupo, descrito na seção Comentários. Se um elemento da matriz for True, será criado um grupo para a hora correspondente; se o elemento for False, nenhum grupo será criado. Se o campo não for um campo de data, esse argumento será ignorado. |
Variant
A matriz Boolean do parâmetro Periods contém os seguintes elementos:
Elemento da matriz | Period |
---|---|
1 | Segundos |
2 | Minutos |
3 | Horas |
4 | Dias |
5 | Meses |
6 | Quartos |
7 | Anos |
Em função do grupo de formas ser tratado como uma forma única, o agrupamento e o desagrupamento das formas altera o número de itens da coleção Shapes e altera os números indexados de itens que vêm após os itens afetados na coleção.
O objeto Range deve ser uma única célula no intervalo de dados do campo tabela dinâmica. Se você tentar aplicar este método a mais de uma célula, ele falhará (sem exibir uma mensagem de erro).
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.