Compartilhar via


Excel.WorksheetSingleClickedEventArgs interface

Fornece informações sobre o evento clicado/tocado à esquerda e a respetiva folha de cálculo relacionada.

Comentários

[ Conjunto de API: ExcelApi 1.10 ]

Propriedades

address

Obtém o endereço que representa a célula que foi clicada/tocada para uma planilha específica.

offsetX

A distância, em pontos, desde o ponto esquerdo clicado/tocado até à margem da linha de grelha esquerda (ou direita para idiomas da direita para a esquerda) da célula clicada/tocada à esquerda.

offsetY

A distância, em pontos, desde o ponto clicado/tocado com o botão esquerdo até a borda da linha de grade superior da célula clicada/tocada com o botão esquerdo.

type

Obtém o tipo do evento.

worksheetId

Obtém o ID da folha de cálculo na qual a célula foi clicada/tocada à esquerda.

Detalhes da propriedade

address

Obtém o endereço que representa a célula que foi clicada/tocada para uma planilha específica.

address: string;

Valor da propriedade

string

Comentários

[ Conjunto de API: ExcelApi 1.10 ]

Exemplos

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/30-events/event-worksheet-single-click.yaml

await Excel.run(async (context) => {
    const sheet = context.workbook.worksheets.getActiveWorksheet();
    sheet.onSingleClicked.add((event) => {
        return Excel.run((context) => {
            console.log(`Click detected at ${event.address} (pixel offset from upper-left cell corner: ${event.offsetX}, ${event.offsetY})`);
            return context.sync();
        });
    });

    console.log("The worksheet click handler is registered.");

    await context.sync();
});

offsetX

A distância, em pontos, desde o ponto esquerdo clicado/tocado até à margem da linha de grelha esquerda (ou direita para idiomas da direita para a esquerda) da célula clicada/tocada à esquerda.

offsetX: number;

Valor da propriedade

number

Comentários

[ Conjunto de API: ExcelApi 1.10 ]

offsetY

A distância, em pontos, desde o ponto clicado/tocado com o botão esquerdo até a borda da linha de grade superior da célula clicada/tocada com o botão esquerdo.

offsetY: number;

Valor da propriedade

number

Comentários

[ Conjunto de API: ExcelApi 1.10 ]

type

Obtém o tipo do evento.

type: "WorksheetSingleClicked";

Valor da propriedade

"WorksheetSingleClicked"

Comentários

[ Conjunto de API: ExcelApi 1.10 ]

worksheetId

Obtém o ID da folha de cálculo na qual a célula foi clicada/tocada à esquerda.

worksheetId: string;

Valor da propriedade

string

Comentários

[ Conjunto de API: ExcelApi 1.10 ]