Excel.WorksheetChangedEventArgs interface
Fournit des informations sur la feuille de calcul qui a déclenché l’événement modifié.
Remarques
Utilisateur
Propriétés
| address | Obtient l’adresse de plage qui représente la zone modifiée dans une feuille de calcul spécifique. |
| change |
Obtient le type de modification qui représente la façon dont l’événement modifié est déclenché. Pour |
| details | Représente les informations sur les détails de la modification. Cette propriété peut être récupérée lorsque l’événement modifié est déclenché sur une seule cellule. Si l’événement modifié est déclenché sur plusieurs cellules, cette propriété ne peut pas être récupérée. |
| source | Obtient la source de l’événement. Pour |
| type | Obtient le type de l’événement. Pour |
| worksheet |
Obtient l’ID de la feuille de calcul dans laquelle les données ont changé. |
Méthodes
| get |
Obtient l’adresse de plage qui représente la zone modifiée dans une feuille de calcul spécifique. |
| get |
Obtient l’adresse de plage qui représente la zone modifiée dans une feuille de calcul spécifique. Il peut renvoyer un objet null. |
Détails de la propriété
address
Obtient l’adresse de plage qui représente la zone modifiée dans une feuille de calcul spécifique.
address: string;
Valeur de propriété
string
Remarques
changeType
Obtient le type de modification qui représente la façon dont l’événement modifié est déclenché. Pour Excel.DataChangeType plus de détails.
changeType: Excel.DataChangeType | "Unknown" | "RangeEdited" | "RowInserted" | "RowDeleted" | "ColumnInserted" | "ColumnDeleted" | "CellInserted" | "CellDeleted";
Valeur de propriété
Excel.DataChangeType | "Unknown" | "RangeEdited" | "RowInserted" | "RowDeleted" | "ColumnInserted" | "ColumnDeleted" | "CellInserted" | "CellDeleted"
Remarques
details
Représente les informations sur les détails de la modification. Cette propriété peut être récupérée lorsque l’événement modifié est déclenché sur une seule cellule. Si l’événement modifié est déclenché sur plusieurs cellules, cette propriété ne peut pas être récupérée.
details: Excel.ChangedEventDetail;
Valeur de propriété
Remarques
Exemples
// This function would be used as an event handler for the Worksheet.onChanged event.
async function onWorksheetChanged(eventArgs) {
await Excel.run(async (context) => {
const details = eventArgs.details;
const address = eventArgs.address;
// Print the before and after types and values to the console.
console.log(`Change at ${address}: was ${details.valueBefore}(${details.valueTypeBefore}),`
+ ` now is ${details.valueAfter}(${details.valueTypeAfter})`);
await context.sync();
});
}
source
Obtient la source de l’événement. Pour Excel.EventSource plus de détails.
source: Excel.EventSource | "Local" | "Remote";
Valeur de propriété
Excel.EventSource | "Local" | "Remote"
Remarques
type
Obtient le type de l’événement. Pour Excel.EventType plus de détails.
type: "WorksheetChanged";
Valeur de propriété
"WorksheetChanged"
Remarques
worksheetId
Obtient l’ID de la feuille de calcul dans laquelle les données ont changé.
worksheetId: string;
Valeur de propriété
string
Remarques
Détails de la méthode
getRange(ctx)
Obtient l’adresse de plage qui représente la zone modifiée dans une feuille de calcul spécifique.
getRange(ctx: Excel.RequestContext): Excel.Range;
Paramètres
Retours
getRangeOrNullObject(ctx)
Obtient l’adresse de plage qui représente la zone modifiée dans une feuille de calcul spécifique. Il peut renvoyer un objet null.
getRangeOrNullObject(ctx: Excel.RequestContext): Excel.Range;