Método SortFields.Add2 (Excel)

Cria um novo campo de classificação e retorna um objeto SortFields que pode, opcionalmente, classificar tipos de dados com o SubField definido.

Sintaxe

expressão. Add2 (Key, SortOn, Order, CustomOrder, DataOption, SubField)

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 O campo a ser classificado.
Order Opcional Variant Especifica a ordem de classificação.
CustomOrder Opcional Variant Especifica se uma ordem de classificação personalizada deve ser usada.
DataOption Opcional Variant Especifica a opção de dados.
SubField Optional Variant Especifica o campo a ser classificação para um tipo de dados (como População para Geografia ou Volume para Ações).

Valor de retorno

SortField

Comentários

Essa API inclui suporte para classificar um SubField de tipos de dados, como Geografia ou Ações. Você também pode usar o método Add se a classificação por um tipo de dados não for necessária.

Ao contrário de fórmulas, SubFields não exige colchetes para incluir espaços.

Exemplo

Este exemplo classifica uma tabela, Table1 em Sheet1, por Column1 em ordem crescente com base na População de SubField em tipos de dados geográficos.

O método Clear é chamado antes para garantir que a classificação anterior seja limpa para que um novo possa ser aplicado.

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

ActiveWorkbook.Worksheets("Sheet1").ListObjects("Table1").Sort.SortFields.Clear
ActiveWorkbook.Worksheets("Sheet1").ListObjects("Table1").Sort.SortFields.Add2 _
 Key:=Range("Table1[[#All],[Column1]]"), _
 SortOn:=xlSortOnValues, _
 Order:=xlAscending, _
 DataOption:=xlSortNormal, _
 SubField:="Population"
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.