Compartilhar via

Excel.TableChangedEventArgs interface

  • Referência
Pacote:
excel

Fornece informações sobre a tabela que levantou o evento alterado.

Comentários

[ Conjunto de API: ExcelApi 1.7 ]

Propriedades

address

Obtém o endereço que representa a área alterada de uma tabela em uma planilha específica.
changeType

Obtém o tipo de alteração que representa a forma como o evento alterado é acionado. Veja Excel.DataChangeType para obter detalhes.
source

Obtém a origem do evento. Veja Excel.EventSource para obter detalhes.
tableId

Obtém o ID da tabela na qual os dados foram alterados.
type

Obtém o tipo do evento. Veja Excel.EventType para obter detalhes.
worksheetId

Obtém o ID da folha de cálculo na qual os dados foram alterados.

Detalhes da propriedade

address

Obtém o endereço que representa a área alterada de uma tabela em uma planilha específica.

address: string;

Valor da propriedade

string

Comentários

[ Conjunto de API: ExcelApi 1.7 ]

changeType

Obtém o tipo de alteração que representa a forma como o evento alterado é acionado. Veja Excel.DataChangeType para obter detalhes.

changeType: Excel.DataChangeType | "Unknown" | "RangeEdited" | "RowInserted" | "RowDeleted" | "ColumnInserted" | "ColumnDeleted" | "CellInserted" | "CellDeleted";

Valor da propriedade

Excel.DataChangeType | "Unknown" | "RangeEdited" | "RowInserted" | "RowDeleted" | "ColumnInserted" | "ColumnDeleted" | "CellInserted" | "CellDeleted"

Comentários

[ Conjunto de API: ExcelApi 1.7 ]

source

Obtém a origem do evento. Veja Excel.EventSource para obter detalhes.

source: Excel.EventSource | "Local" | "Remote";

Valor da propriedade

Excel.EventSource | "Local" | "Remote"

Comentários

[ Conjunto de API: ExcelApi 1.7 ]

tableId

Obtém o ID da tabela na qual os dados foram alterados.

tableId: string;

Valor da propriedade

string

Comentários

[ Conjunto de API: ExcelApi 1.7 ]

Exemplos

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/30-events/events-tablecollection-changed.yaml

async function onChange(event) {
    await Excel.run(async (context) => {
        let table = context.workbook.tables.getItem(event.tableId);
        let worksheet = context.workbook.worksheets.getItem(event.worksheetId);
        worksheet.load("name");

        await context.sync();

        console.log("Handler for table collection onChanged event has been triggered. Data changed address: " + event.address);
        console.log("Table Id : " + event.tableId);
        console.log("Worksheet Id : " + worksheet.name);
    });
}

type

Obtém o tipo do evento. Veja Excel.EventType para obter detalhes.

type: "TableChanged";

Valor da propriedade

"TableChanged"

Comentários

[ Conjunto de API: ExcelApi 1.7 ]

worksheetId

Obtém o ID da folha de cálculo na qual os dados foram alterados.

worksheetId: string;

Valor da propriedade

string

Comentários

[ Conjunto de API: ExcelApi 1.7 ]

Exemplos

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/30-events/events-tablecollection-changed.yaml

async function onChange(event) {
    await Excel.run(async (context) => {
        let table = context.workbook.tables.getItem(event.tableId);
        let worksheet = context.workbook.worksheets.getItem(event.worksheetId);
        worksheet.load("name");

        await context.sync();

        console.log("Handler for table collection onChanged event has been triggered. Data changed address: " + event.address);
        console.log("Table Id : " + event.tableId);
        console.log("Worksheet Id : " + worksheet.name);
    });
}