Excel.WorksheetMovedEventArgs interface
Avertit lorsqu’une feuille de calcul est déplacée au sein d’un classeur.
Si une feuille de calcul est déplacée d’une position dans le classeur à une autre via l’interface utilisateur Excel, cette API déclenche un événement. Notez que si la position d’une feuille de calcul change à la suite du déplacement d’une autre feuille de calcul, cet événement ne se déclenche pas pour les deux changements de position. Cet événement se déclenche uniquement pour le déplacement de la feuille de calcul principale, et non pour les changements de position de feuille de calcul qui se produisent à la suite de ce déplacement principal.
Remarques
Utilisateur
Exemples
// 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}`);
});
}
Propriétés
| position |
Obtient la nouvelle position de la feuille de calcul, après le déplacement. |
| position |
Obtient la position précédente de la feuille de calcul, avant le déplacement. |
| source | Source de l'événement. Il peut être local ou distant (par le biais de la co-édition). |
| type | Obtient le type de l’événement. |
| worksheet |
Obtient l’ID de la feuille de calcul qui a été déplacée. |
Détails de la propriété
positionAfter
Obtient la nouvelle position de la feuille de calcul, après le déplacement.
positionAfter: number;Valeur de propriété
number
Remarques
positionBefore
Obtient la position précédente de la feuille de calcul, avant le déplacement.
positionBefore: number;Valeur de propriété
number
Remarques
source
Source de l'événement. Il peut être local ou distant (par le biais de la co-édition).
source: Excel.EventSource | "Local" | "Remote";Valeur de propriété
Excel.EventSource | "Local" | "Remote"
Remarques
type
Obtient le type de l’événement.
type: string;Valeur de propriété
string
Remarques
worksheetId
Obtient l’ID de la feuille de calcul qui a été déplacée.
worksheetId: string;Valeur de propriété
string