Compartilhar via

Excel.WorksheetProtectionChangedEventArgs interface

  • Referência
Pacote:
excel

Fornece informações sobre a folha de cálculo que elevou a proteção status evento alterado, que é acionado quando a proteção status é atualizada numa folha de cálculo.

Comentários

[ Conjunto de API: ExcelApi 1.14 ]

Propriedades

allowEditRangesChanged

Especifica se algum dos AllowEditRange objetos foi alterado.
isProtected

Obtém a proteção atual status da folha de cálculo.
protectionOptionsChanged

Especifica se o WorksheetProtectionOptions foi alterado.
sheetPasswordChanged

Especifica se a palavra-passe da folha de cálculo foi alterada.
source

A origem do evento. Pode ser local ou remoto (através da cocriação).
type

Obtém o tipo do evento. Veja Excel.EventType para obter detalhes.
worksheetId

Obtém o ID da folha de cálculo na qual a proteção status é alterada.

Detalhes da propriedade

allowEditRangesChanged

Especifica se algum dos AllowEditRange objetos foi alterado.

allowEditRangesChanged: boolean;

Valor da propriedade

boolean

Comentários

[ Conjunto de API: ExcelApiOnline 1.1 ]

isProtected

Obtém a proteção atual status da folha de cálculo.

isProtected: boolean;

Valor da propriedade

boolean

Comentários

[ Conjunto de API: ExcelApi 1.14 ]

Exemplos

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

Especifica se o WorksheetProtectionOptions foi alterado.

protectionOptionsChanged: boolean;

Valor da propriedade

boolean

Comentários

[ Conjunto de API: ExcelApiOnline 1.1 ]

sheetPasswordChanged

Especifica se a palavra-passe da folha de cálculo foi alterada.

sheetPasswordChanged: boolean;

Valor da propriedade

boolean

Comentários

[ Conjunto de API: ExcelApiOnline 1.1 ]

source

A origem do evento. Pode ser local ou remoto (através da cocriação).

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

Valor da propriedade

Excel.EventSource | "Local" | "Remote"

Comentários

[ Conjunto de API: ExcelApi 1.14 ]

Exemplos

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

Obtém o tipo do evento. Veja Excel.EventType para obter detalhes.

type: "WorksheetProtectionChanged";

Valor da propriedade

"WorksheetProtectionChanged"

Comentários

[ Conjunto de API: ExcelApi 1.14 ]

worksheetId

Obtém o ID da folha de cálculo na qual a proteção status é alterada.

worksheetId: string;

Valor da propriedade

string

Comentários

[ Conjunto de API: ExcelApi 1.14 ]

Exemplos

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