Excel.WorksheetProtectionChangedEventArgs interface
Fournit des informations sur la feuille de calcul qui a déclenché l’événement de modification de l’état de protection, qui se déclenche lorsque l’état de protection est mis à jour dans une feuille de calcul.
Remarques
[ Ensemble d’API : ExcelApi 1.14 ]
Propriétés
allow |
Spécifie si l’un |
is |
Obtient l’état de protection actuel de la feuille de calcul. |
protection |
Spécifie si ont changé. |
sheet |
Spécifie si le mot de passe de la feuille de calcul a été modifié. |
source | Source de l'événement. Il peut être local ou distant (via la co-création). |
type | Obtient le type de l’événement. Pour plus d’informations, consultez |
worksheet |
Obtient l’ID de la feuille de calcul dans laquelle l’état de protection est modifié. |
Détails de la propriété
allowEditRangesChanged
Spécifie si l’un AllowEditRange
des objets a changé.
allowEditRangesChanged: boolean;
Valeur de propriété
boolean
Remarques
isProtected
Obtient l’état de protection actuel de la feuille de calcul.
isProtected: boolean;
Valeur de propriété
boolean
Remarques
[ Ensemble d’API : ExcelApi 1.14 ]
Exemples
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/30-events/events-worksheet-protection.yaml
async function checkProtection(event: Excel.WorksheetProtectionChangedEventArgs) {
// This function is an event handler that returns the protection status of a worksheet
// and information about the changed worksheet.
await Excel.run(async (context) => {
const protectionStatus = event.isProtected;
const worksheetId = event.worksheetId;
const source = event.source;
console.log("Protection status changed. Protection status is now: " + protectionStatus + ".");
console.log(" ID of changed worksheet: " + worksheetId + ".");
console.log(" Source of change event: " + source + ".");
});
}
protectionOptionsChanged
Spécifie si ont changé.WorksheetProtectionOptions
protectionOptionsChanged: boolean;
Valeur de propriété
boolean
Remarques
sheetPasswordChanged
Spécifie si le mot de passe de la feuille de calcul a été modifié.
sheetPasswordChanged: boolean;
Valeur de propriété
boolean
Remarques
source
Source de l'événement. Il peut être local ou distant (via la co-création).
source: Excel.EventSource | "Local" | "Remote";
Valeur de propriété
Excel.EventSource | "Local" | "Remote"
Remarques
[ Ensemble d’API : ExcelApi 1.14 ]
Exemples
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/30-events/events-worksheet-protection.yaml
async function checkProtection(event: Excel.WorksheetProtectionChangedEventArgs) {
// This function is an event handler that returns the protection status of a worksheet
// and information about the changed worksheet.
await Excel.run(async (context) => {
const protectionStatus = event.isProtected;
const worksheetId = event.worksheetId;
const source = event.source;
console.log("Protection status changed. Protection status is now: " + protectionStatus + ".");
console.log(" ID of changed worksheet: " + worksheetId + ".");
console.log(" Source of change event: " + source + ".");
});
}
type
Obtient le type de l’événement. Pour plus d’informations, consultez Excel.EventType
.
type: "WorksheetProtectionChanged";
Valeur de propriété
"WorksheetProtectionChanged"
Remarques
worksheetId
Obtient l’ID de la feuille de calcul dans laquelle l’état de protection est modifié.
worksheetId: string;
Valeur de propriété
string
Remarques
[ Ensemble d’API : ExcelApi 1.14 ]
Exemples
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/30-events/events-worksheet-protection.yaml
async function checkProtection(event: Excel.WorksheetProtectionChangedEventArgs) {
// This function is an event handler that returns the protection status of a worksheet
// and information about the changed worksheet.
await Excel.run(async (context) => {
const protectionStatus = event.isProtected;
const worksheetId = event.worksheetId;
const source = event.source;
console.log("Protection status changed. Protection status is now: " + protectionStatus + ".");
console.log(" ID of changed worksheet: " + worksheetId + ".");
console.log(" Source of change event: " + source + ".");
});
}
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