Compartilhar via


Excel.TableSort class

Gere operações de ordenação em Table objetos.

Extends

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

Propriedades

context

O contexto do pedido associado ao objeto . Esta ação liga o processo do suplemento ao processo da aplicação anfitriã do Office.

fields

Especifica as condições atuais utilizadas para ordenar a tabela pela última vez.

matchCase

Especifica se a caixa afeta o último tipo da tabela.

method

Representa o método de ordenação de carateres chinês utilizado pela última vez para ordenar a tabela.

Métodos

apply(fields, matchCase, method)

Executa uma operação de classificação.

apply(fields, matchCase, methodString)

Executa uma operação de classificação.

clear()

Limpa a classificação que está na tabela. Essa ação não modifica a ordenação da tabela, mas limpa o estado dos botões do cabeçalho.

load(options)

Coloca um comando na fila para carregar as propriedades especificadas do objeto. Você deve chamar context.sync() antes de ler as propriedades.

load(propertyNames)

Coloca um comando na fila para carregar as propriedades especificadas do objeto. Você deve chamar context.sync() antes de ler as propriedades.

load(propertyNamesAndPaths)

Coloca um comando na fila para carregar as propriedades especificadas do objeto. Você deve chamar context.sync() antes de ler as propriedades.

reapply()

Reaplica os parâmetros de classificação atuais à tabela.

toJSON()

Substitui o método JavaScript toJSON() para fornecer uma saída mais útil quando um objeto de API é transmitido para JSON.stringify(). (JSON.stringifypor sua vez, chama o toJSON método do objeto que lhe é transmitido.) Enquanto o objeto Excel.TableSort original é um objeto de API, o toJSON método devolve um objeto JavaScript simples (escrito como Excel.Interfaces.TableSortData) que contém cópias rasas de quaisquer propriedades subordinadas carregadas do objeto original.

Detalhes da propriedade

context

O contexto do pedido associado ao objeto . Esta ação liga o processo do suplemento ao processo da aplicação anfitriã do Office.

context: RequestContext;

Valor da propriedade

fields

Especifica as condições atuais utilizadas para ordenar a tabela pela última vez.

readonly fields: Excel.SortField[];

Valor da propriedade

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

matchCase

Especifica se a caixa afeta o último tipo da tabela.

readonly matchCase: boolean;

Valor da propriedade

boolean

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

method

Representa o método de ordenação de carateres chinês utilizado pela última vez para ordenar a tabela.

readonly method: Excel.SortMethod | "PinYin" | "StrokeCount";

Valor da propriedade

Excel.SortMethod | "PinYin" | "StrokeCount"

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

Detalhes do método

apply(fields, matchCase, method)

Executa uma operação de classificação.

apply(fields: Excel.SortField[], matchCase?: boolean, method?: Excel.SortMethod): void;

Parâmetros

fields

Excel.SortField[]

A lista de condições para a classificação.

matchCase

boolean

Opcional. Define se o uso de maiúsculas ou minúsculas afeta a ordenação da cadeia de caracteres.

method
Excel.SortMethod

Opcional. O método de ordenação usado pelos caracteres chineses.

Retornos

void

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

Exemplos

await Excel.run(async (context) => { 
    const tableName = 'Table1';
    const table = context.workbook.tables.getItem(tableName);
    table.sort.apply([ 
            {
                key: 2,
                ascending: true
            },
        ], true);
    await context.sync(); 
});

apply(fields, matchCase, methodString)

Executa uma operação de classificação.

apply(fields: Excel.SortField[], matchCase?: boolean, methodString?: "PinYin" | "StrokeCount"): void;

Parâmetros

fields

Excel.SortField[]

A lista de condições para a classificação.

matchCase

boolean

Opcional. Define se o uso de maiúsculas ou minúsculas afeta a ordenação da cadeia de caracteres.

methodString

"PinYin" | "StrokeCount"

Opcional. O método de ordenação usado pelos caracteres chineses.

Retornos

void

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

clear()

Limpa a classificação que está na tabela. Essa ação não modifica a ordenação da tabela, mas limpa o estado dos botões do cabeçalho.

clear(): void;

Retornos

void

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

load(options)

Coloca um comando na fila para carregar as propriedades especificadas do objeto. Você deve chamar context.sync() antes de ler as propriedades.

load(options?: Excel.Interfaces.TableSortLoadOptions): Excel.TableSort;

Parâmetros

options
Excel.Interfaces.TableSortLoadOptions

Fornece opções para as propriedades do objeto a carregar.

Retornos

load(propertyNames)

Coloca um comando na fila para carregar as propriedades especificadas do objeto. Você deve chamar context.sync() antes de ler as propriedades.

load(propertyNames?: string | string[]): Excel.TableSort;

Parâmetros

propertyNames

string | string[]

Uma cadeia delimitada por vírgulas ou uma matriz de cadeias que especificam as propriedades a carregar.

Retornos

load(propertyNamesAndPaths)

Coloca um comando na fila para carregar as propriedades especificadas do objeto. Você deve chamar context.sync() antes de ler as propriedades.

load(propertyNamesAndPaths?: {
            select?: string;
            expand?: string;
        }): Excel.TableSort;

Parâmetros

propertyNamesAndPaths

{ select?: string; expand?: string; }

propertyNamesAndPaths.select é uma cadeia delimitada por vírgulas que especifica as propriedades a carregar e propertyNamesAndPaths.expand é uma cadeia delimitada por vírgulas que especifica as propriedades de navegação a carregar.

Retornos

reapply()

Reaplica os parâmetros de classificação atuais à tabela.

reapply(): void;

Retornos

void

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

toJSON()

Substitui o método JavaScript toJSON() para fornecer uma saída mais útil quando um objeto de API é transmitido para JSON.stringify(). (JSON.stringifypor sua vez, chama o toJSON método do objeto que lhe é transmitido.) Enquanto o objeto Excel.TableSort original é um objeto de API, o toJSON método devolve um objeto JavaScript simples (escrito como Excel.Interfaces.TableSortData) que contém cópias rasas de quaisquer propriedades subordinadas carregadas do objeto original.

toJSON(): Excel.Interfaces.TableSortData;

Retornos