Excel.WorksheetMovedEventArgs interface
Benachrichtigt, wenn ein Arbeitsblatt innerhalb einer Arbeitsmappe verschoben wird.
Wenn ein Arbeitsblatt über die Excel-Benutzeroberfläche von einer Position innerhalb der Arbeitsmappe an eine andere verschoben wird, löst diese API ein Ereignis aus. Beachten Sie, dass, wenn sich die Position eines Arbeitsblatts infolge des Verschiebens eines anderen Arbeitsblatts ändert, dieses Ereignis nicht für beide Positionsänderungen ausgelöst wird. Dieses Ereignis wird nur für die primäre Arbeitsblattverschiebung ausgelöst und nicht für Änderungen der Arbeitsblattposition, die als Ergebnis dieser primären Verschiebung auftreten.
Hinweise
Verwendet von
Beispiele
// 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}`);
});
}
Eigenschaften
| position |
Ruft die neue Position des Arbeitsblatts nach dem Verschieben ab. |
| position |
Ruft die vorherige Position des Arbeitsblatts vor dem Verschieben ab. |
| source | Die Quelle des Ereignisses. Dies kann lokal oder remote (durch gemeinsame Dokumenterstellung) erfolgen. |
| type | Ruft den Typ des Ereignisses ab. |
| worksheet |
Ruft die ID des Arbeitsblatts ab, das verschoben wurde. |
Details zur Eigenschaft
positionAfter
Ruft die neue Position des Arbeitsblatts nach dem Verschieben ab.
positionAfter: number;Eigenschaftswert
number
Hinweise
positionBefore
Ruft die vorherige Position des Arbeitsblatts vor dem Verschieben ab.
positionBefore: number;Eigenschaftswert
number
Hinweise
source
Die Quelle des Ereignisses. Dies kann lokal oder remote (durch gemeinsame Dokumenterstellung) erfolgen.
source: Excel.EventSource | "Local" | "Remote";Eigenschaftswert
Excel.EventSource | "Local" | "Remote"
Hinweise
type
Ruft den Typ des Ereignisses ab.
type: string;Eigenschaftswert
string
Hinweise
worksheetId
Ruft die ID des Arbeitsblatts ab, das verschoben wurde.
worksheetId: string;Eigenschaftswert
string