Excel.WorksheetSingleClickedEventArgs interface

包:

excel

提供有关左键单击/点击事件及其相关工作表的信息。

注解

[ API 集：ExcelApi 1.10 ]

属性

address	获取特定工作表中表示被左键单击/点击的单元格的地址。
offsetX	从左键单击/点击的点到左 (或从右到左语言的距离（以磅为单位），) 左单击/点击单元格的网格线边缘。
offsetY	从左键单击/点击的点到左键单击/点击的单元格的顶部网格线边缘的距离（以磅为单位）。
type	获取事件的类型。
worksheetId	获取单元格左键单击/点击的工作表的 ID。

属性详细信息

address

获取特定工作表中表示被左键单击/点击的单元格的地址。

address: string;

属性值

string

注解

[ API 集：ExcelApi 1.10 ]

示例

// 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

从左键单击/点击的点到左 (或从右到左语言的距离（以磅为单位），) 左单击/点击单元格的网格线边缘。

offsetX: number;

属性值

number

注解

[ API 集：ExcelApi 1.10 ]

offsetY

从左键单击/点击的点到左键单击/点击的单元格的顶部网格线边缘的距离（以磅为单位）。

offsetY: number;

属性值

number

注解

[ API 集：ExcelApi 1.10 ]

type

获取事件的类型。

type: "WorksheetSingleClicked";

属性值

"WorksheetSingleClicked"

注解

[ API 集：ExcelApi 1.10 ]

worksheetId

获取单元格左键单击/点击的工作表的 ID。

worksheetId: string;

属性值

string

注解

[ API 集：ExcelApi 1.10 ]