Freigeben über

Excel.WorksheetProtectionChangedEventArgs interface

  • Referenz
Paket:
excel

Stellt Informationen zu dem Arbeitsblatt bereit, das den Schutz status geänderten Ereignis ausgelöst hat, das ausgelöst wird, wenn der Schutz status in einem Arbeitsblatt aktualisiert wird.

Hinweise

[ API-Satz: ExcelApi 1.14 ]

Eigenschaften

allowEditRangesChanged

Gibt an, ob eines der AllowEditRange Objekte geändert wurde.
isProtected

Ruft den aktuellen Schutz status des Arbeitsblatts ab.
protectionOptionsChanged

Gibt an, ob geändert WorksheetProtectionOptions wurde.
sheetPasswordChanged

Gibt an, ob das Arbeitsblattkennwort geändert wurde.
source

Die Quelle des Ereignisses. Dies kann lokal oder remote sein (durch gemeinsame Dokumenterstellung).
type

Ruft den Typ des Ereignisses ab. Weitere Informationen finden Sie unter Excel.EventType .
worksheetId

Ruft die ID des Arbeitsblatts ab, in dem der Schutz status geändert wird.

Details zur Eigenschaft

allowEditRangesChanged

Gibt an, ob eines der AllowEditRange Objekte geändert wurde.

allowEditRangesChanged: boolean;

Eigenschaftswert

boolean

Hinweise

[ API-Satz: ExcelApiOnline 1.1 ]

isProtected

Ruft den aktuellen Schutz status des Arbeitsblatts ab.

isProtected: boolean;

Eigenschaftswert

boolean

Hinweise

[ API-Satz: ExcelApi 1.14 ]

Beispiele

// 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

Gibt an, ob geändert WorksheetProtectionOptions wurde.

protectionOptionsChanged: boolean;

Eigenschaftswert

boolean

Hinweise

[ API-Satz: ExcelApiOnline 1.1 ]

sheetPasswordChanged

Gibt an, ob das Arbeitsblattkennwort geändert wurde.

sheetPasswordChanged: boolean;

Eigenschaftswert

boolean

Hinweise

[ API-Satz: ExcelApiOnline 1.1 ]

source

Die Quelle des Ereignisses. Dies kann lokal oder remote sein (durch gemeinsame Dokumenterstellung).

source: Excel.EventSource | "Local" | "Remote";

Eigenschaftswert

Excel.EventSource | "Local" | "Remote"

Hinweise

[ API-Satz: ExcelApi 1.14 ]

Beispiele

// 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

Ruft den Typ des Ereignisses ab. Weitere Informationen finden Sie unter Excel.EventType .

type: "WorksheetProtectionChanged";

Eigenschaftswert

"WorksheetProtectionChanged"

Hinweise

[ API-Satz: ExcelApi 1.14 ]

worksheetId

Ruft die ID des Arbeitsblatts ab, in dem der Schutz status geändert wird.

worksheetId: string;

Eigenschaftswert

string

Hinweise

[ API-Satz: ExcelApi 1.14 ]

Beispiele

// 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 + ".");
    });
}