Método Range.Sort (Excel)

Artigo
10/25/2024

Classifica um intervalo de valores.

Sintaxe

expressão. Ordenar (Key1, Order1, Key2, Type, Order2, Key3, Order3, Header, OrderCustom, MatchCase, Orientation, SortMethod, DataOption1, DataOption2, DataOption3)

expressão Uma variável que representa um objeto de Intervalo.

Parâmetros

Nome	Obrigatório/Opcional	Tipo de dados	Descrição
Key1	Opcional	Variant	Especifica o primeiro campo de ordenação, como um nome de intervalo (Cadeia) ou objeto Intervalo ; determina os valores a ordenar.
Order1	Opcional	XlSortOrder	Determina a ordem de classificação para os valores especificados na Chave1.
Key2	Opcional	Variant	Segundo campo de ordenação; não pode ser utilizado ao ordenar uma tabela dinâmica.
Type	Opcional	Variant	Especifica que tipo de elementos devem ser ordenados numa tabela dinâmica. Especifique xLSortLabels para ordenar pelas etiquetas visadas pelo Intervalo de Experessão nas áreas Rótulos de Linha/Coluna do intervalo da Tabela Dinâmica ou xLSortValues quando Key1 destinar-se adicionalmente a uma célula nas áreas Valores ou Totais Inferiores/Gerais através da notação R1C1.
Order2	Opcional	XlSortOrder	Determina a sequência de ordenação dos valores especificados em Key2.
Key3	Opcional	Variant	Terceiro campo de ordenação; não pode ser utilizado ao ordenar uma tabela dinâmica.
Order3	Opcional	XlSortOrder	Determina a ordem de classificação para os valores especificados na Chave3.
Header	Opcional	XlYesNoGuess	Especifica se a primeira linha contém informações de cabeçalho. xlNo é o valor padrão; você pode especificar xlGuess se desejar que o Excel tente determinar o cabeçalho.
OrderCustom	Opcional	Variant	Especifica um deslocamento de inteiro baseado em um na lista de ordens de classificação personalizadas.
MatchCase	Opcional	Variant	Defina como Verdadeiro para executar uma ordenação sensível às maiúsculas e minúsculas, Falso para executar uma ordenação não sensível a maiúsculas e minúsculas; não pode ser utilizado com tabelas dinâmicas.
Orientation	Opcional	XlSortOrientation	Especifica se a classificação deve ser a coluna ou linha (padrão). Defina o valor xlSortColumns como 1 para ordenar por coluna. Defina xlSortRows valor como 2 para ordenar por linha (este é o valor predefinido).
SortMethod	Opcional	XlSortMethod	Especifica o método de classificação.
DataOption1	Opcional	XlSortDataOption	Especifica como ordenar texto no intervalo especificado em Chave1; não se aplica à ordenação de tabela dinâmica.
DataOption2	Opcional	XlSortDataOption	Especifica como ordenar texto no intervalo especificado em Chave2; não se aplica à ordenação de tabela dinâmica.
DataOption3	Opcional	XlSortDataOption	Especifica como ordenar texto no intervalo especificado em Key3; não se aplica à ordenação de tabela dinâmica.

Valor de retorno

Variant

Exemplo

Este exemplo obtém o valor da cor de uma célula na coluna A com a propriedade ColorIndex e, em seguida, utiliza esse valor para ordenar o intervalo por cor.

Sub ColorSort()
   'Set up your variables and turn off screen updating.
   Dim iCounter As Integer
   Application.ScreenUpdating = False
   
   'For each cell in column A, go through and place the color index value of the cell in column C.
   For iCounter = 2 To 55
      Cells(iCounter, 3) = _
         Cells(iCounter, 1).Interior.ColorIndex
   Next iCounter
   
   'Sort the rows based on the data in column C
   Range("C1") = "Index"
   Columns("A:C").Sort key1:=Range("C2"), _
      order1:=xlAscending, header:=xlYes
   
   'Clear out the temporary sorting value in column C, and turn screen updating back on.
   Columns(3).ClearContents
   Application.ScreenUpdating = True
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.

Compartilhar via