Método SortFields.Add (Excel)

Cria um novo campo de classificação e retorna um objeto SortFields.

Sintaxe

mais simples. Add (Key, SortOn, Order, CustomOrder, DataOption)

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

Parâmetros

Nome Obrigatório/Opcional Tipo de dados Descrição
Tecla Obrigatório Range Especifica um valor de tecla para a classificação.
SortOn Opcional Variant Um valor XlSortOn que especifica qual propriedade de uma célula usar para a classificação.
Order Opcional Variant Um valor XlSortOrder que especifica a ordem de classificação.
CustomOrder Opcional Variant Especifica se uma ordem de classificação personalizada deve ser usada.
DataOption Opcional Variant Um valor XlSortDataOption que especifica como classificar o texto.

Valor de retorno

SortField

Comentários

Essa API não inclui suporte para tipos de dados, como Geography ou Stocks. Para definir uma ordem de classificação com base em um SubField de um desses tipos, consulte o método Add2 .

Exemplo

Este exemplo classifica uma tabela, Tabela1 em Planilha1, por Coluna1 em ordem crescente.

O método Clear é chamado antes para garantir que a classificação anterior seja limpa para que uma nova possa ser aplicada.

O objeto Sort é chamado para aplicar a classificação adicionada à Tabela1.

ActiveWorkbook.Worksheets("Sheet1").ListObjects("Table1").Sort.SortFields.Clear
ActiveWorkbook.Worksheets("Sheet1").ListObjects("Table1").Sort.SortFields.Add _
 Key:=Range("Table1[[#All],[Column1]]"), _
 SortOn:=xlSortOnValues, _
 Order:=xlAscending, _
 DataOption:=xlSortNormal
With ActiveWorkbook.Worksheets("Sheet1").ListObjects("Table1").Sort
 .Header = xlYes
 .MatchCase = False
 .Orientation = xlTopToBottom
 .SortMethod = xlPinYin
 .Apply
End With

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.

  • Last updated on