Compartilhar via

Excel.WorksheetProtectionChangedEventArgs interface

  • Referência
Pacote:
excel

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

Comentários

[ Conjunto de API: ExcelApi 1.14 ]

Propriedades

isProtected

Obtém o estado de proteção atual da folha de cálculo.
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 o estado de proteção é alterado.

Detalhes da propriedade

isProtected

Obtém o estado de proteção atual 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 + ".");
    });
}

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 o estado de proteção é alterado.

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