Excel.WorksheetMovedEventArgs interface

Уведомляет о перемещении листа в книге.

Если лист перемещается из одной позиции в книге в другую с помощью пользовательского интерфейса Excel, этот API активирует событие. Обратите внимание, что если положение листа изменится в результате перемещения другого листа, это событие не будет активировано для обоих изменений положения. Это событие запускается только для основного перемещения листа, но не для любых изменений положения листа, которые происходят в результате этого основного перемещения.

Комментарии

Набор API: ExcelApi 1.17

Используется

Примеры

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/30-events/events-workbook-and-worksheet-collection.yaml

async function onWorksheetMoved(event) {
    await Excel.run(async (context) => {
        console.log("Handler for worksheet onMoved event has been triggered.");
        console.log(`    Worksheet ID: ${event.worksheetId}`);
        console.log(`    Position before move: ${event.positionBefore}`);
        console.log(`    Position after move: ${event.positionAfter}`);
        console.log(`    Event source: ${event.source}`);
    });
}

Свойства

positionAfter

Получает новое положение листа после перемещения.

positionBefore

Получает предыдущее положение листа до перемещения.

source

Источник события. Она может быть локальной или удаленной (путем совместного редактирования).

type

Получает тип события.

worksheetId

Получает идентификатор перемещенного листа.

Сведения о свойстве

positionAfter

Получает новое положение листа после перемещения.

positionAfter: number;

Значение свойства

number

Комментарии

Набор API: ExcelApi 1.17

positionBefore

Получает предыдущее положение листа до перемещения.

positionBefore: number;

Значение свойства

number

Комментарии

Набор API: ExcelApi 1.17

source

Источник события. Она может быть локальной или удаленной (путем совместного редактирования).

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

Значение свойства

Excel.EventSource | "Local" | "Remote"

Комментарии

Набор API: ExcelApi 1.17

type

Получает тип события.

type: string;

Значение свойства

string

Комментарии

Набор API: ExcelApi 1.17

worksheetId

Получает идентификатор перемещенного листа.

worksheetId: string;

Значение свойства

string

Комментарии

Набор API: ExcelApi 1.17