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;
Paramètres
Retours
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour