Share via

Excel.TableSort class

  • Referência
Pacote:
excel

Gerencia operações de classificação em Table objetos.

Extends
OfficeExtension.ClientObject

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

Propriedades

context

O contexto de solicitação associado ao objeto. Isso conecta o processo do suplemento ao processo do aplicativo host do Office.
fields

Especifica as condições atuais usadas para classificar a tabela pela última vez.
matchCase

Especifica se o invólucro afeta o último tipo da tabela.
method

Representa o método de ordenação de caracteres chinês usado pela última vez para classificar 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 é passado para JSON.stringify(). (JSON.stringifypor sua vez, chama o toJSON método do objeto que é passado para ele.) Enquanto o objeto Excel.TableSort original é um objeto API, o toJSON método retorna um objeto JavaScript simples (digitado como Excel.Interfaces.TableSortData) que contém cópias rasas de quaisquer propriedades filho carregadas do objeto original.

Detalhes da propriedade

context

O contexto de solicitação associado ao objeto. Isso conecta o processo do suplemento ao processo do aplicativo host do Office.

context: RequestContext;

Valor da propriedade

Excel.RequestContext

fields

Especifica as condições atuais usadas para classificar a tabela pela última vez.

readonly fields: Excel.SortField[];

Valor da propriedade

Excel.SortField[]

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

matchCase

Especifica se o invólucro 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 caracteres chinês usado pela última vez para classificar 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 quais propriedades do objeto carregar.

Retornos

Excel.TableSort

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 de caracteres delimitada por vírgulas ou uma matriz de cadeias de caracteres que especificam as propriedades a serem carregadas.

Retornos

Excel.TableSort

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 de caracteres delimitada por vírgulas que especifica as propriedades a serem carregadas e propertyNamesAndPaths.expand é uma cadeia de caracteres delimitada por vírgulas que especifica as propriedades de navegação a serem carregadas.

Retornos

Excel.TableSort

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 é passado para JSON.stringify(). (JSON.stringifypor sua vez, chama o toJSON método do objeto que é passado para ele.) Enquanto o objeto Excel.TableSort original é um objeto API, o toJSON método retorna um objeto JavaScript simples (digitado como Excel.Interfaces.TableSortData) que contém cópias rasas de quaisquer propriedades filho carregadas do objeto original.

toJSON(): Excel.Interfaces.TableSortData;

Retornos

Excel.Interfaces.TableSortData