Excel.TableChangedEventArgs interface
Fournit des informations sur la table qui a déclenché l’événement modifié.
Remarques
[ Ensemble d’API : ExcelApi 1.7 ]
Propriétés
address | Obtient l’adresse qui représente la zone modifiée d’un tableau figurant 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 plus d’informations, consultez |
source | Obtient la source de l’événement. Pour plus d’informations, consultez |
table |
Obtient l’ID de la table dans laquelle les données ont été modifiées. |
type | Obtient le type de l’événement. Pour plus d’informations, consultez |
worksheet |
Obtient l’ID de la feuille de calcul dans laquelle les données ont été modifiées. |
Méthodes
get |
Obtient la plage qui représente la zone modifiée d’un tableau sur une feuille de calcul spécifique. |
get |
Obtient la plage qui représente la zone modifiée d’un tableau sur une feuille de calcul spécifique. Il peut renvoyer un objet null. |
Détails de la propriété
address
Obtient l’adresse qui représente la zone modifiée d’un tableau figurant 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 plus d’informations, consultez Excel.DataChangeType
.
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
source
Obtient la source de l’événement. Pour plus d’informations, consultez Excel.EventSource
.
source: Excel.EventSource | "Local" | "Remote";
Valeur de propriété
Excel.EventSource | "Local" | "Remote"
Remarques
tableId
Obtient l’ID de la table dans laquelle les données ont été modifiées.
tableId: string;
Valeur de propriété
string
Remarques
[ Ensemble d’API : ExcelApi 1.7 ]
Exemples
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/30-events/events-tablecollection-changed.yaml
async function onChange(event) {
await Excel.run(async (context) => {
let table = context.workbook.tables.getItem(event.tableId);
let worksheet = context.workbook.worksheets.getItem(event.worksheetId);
worksheet.load("name");
await context.sync();
console.log("Handler for table collection onChanged event has been triggered. Data changed address: " + event.address);
console.log("Table Id : " + event.tableId);
console.log("Worksheet Id : " + worksheet.name);
});
}
type
Obtient le type de l’événement. Pour plus d’informations, consultez Excel.EventType
.
type: "TableChanged";
Valeur de propriété
"TableChanged"
Remarques
worksheetId
Obtient l’ID de la feuille de calcul dans laquelle les données ont été modifiées.
worksheetId: string;
Valeur de propriété
string
Remarques
[ Ensemble d’API : ExcelApi 1.7 ]
Exemples
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/30-events/events-tablecollection-changed.yaml
async function onChange(event) {
await Excel.run(async (context) => {
let table = context.workbook.tables.getItem(event.tableId);
let worksheet = context.workbook.worksheets.getItem(event.worksheetId);
worksheet.load("name");
await context.sync();
console.log("Handler for table collection onChanged event has been triggered. Data changed address: " + event.address);
console.log("Table Id : " + event.tableId);
console.log("Worksheet Id : " + worksheet.name);
});
}
Détails de la méthode
getRange(ctx)
Obtient la plage qui représente la zone modifiée d’un tableau sur une feuille de calcul spécifique.
[ Ensemble d’API : ExcelApi 1.8 ]
getRange(ctx: Excel.RequestContext): Excel.Range;
Paramètres
Retours
getRangeOrNullObject(ctx)
Obtient la plage qui représente la zone modifiée d’un tableau sur une feuille de calcul spécifique. Il peut renvoyer un objet null.
[ Ensemble d’API : ExcelApi 1.8 ]
getRangeOrNullObject(ctx: Excel.RequestContext): Excel.Range;