Excel.WorksheetProtection class
Representa a proteção de um objeto de folha de cálculo.
- Extends
Comentários
[ Conjunto de API: ExcelApi 1.2 ]
Propriedades
| allow |
Especifica o |
| can |
Especifica se a proteção pode ser colocada em pausa para esta folha de cálculo. |
| context | O contexto do pedido associado ao objeto . Esta ação liga o processo do suplemento ao processo da aplicação anfitriã do Office. |
| is |
Especifica se a folha está protegida por palavra-passe. |
| is |
Especifica se a proteção da folha de cálculo está em pausa. |
| options | Especifica as opções de proteção para a folha de cálculo. |
| protected | Especifica se a folha de cálculo está protegida. |
| saved |
Especifica as opções de proteção guardadas na folha de cálculo. Esta ação irá devolver o mesmo |
Métodos
| check |
Especifica se a palavra-passe pode ser utilizada para desbloquear a proteção da folha de cálculo. Este método não altera o estado de proteção da folha de cálculo. Se for introduzida uma palavra-passe, mas não for necessária nenhuma palavra-passe para desbloquear a proteção da folha de cálculo, este método devolverá false. |
| load(options) | Coloca um comando na fila para carregar as propriedades especificadas do objeto. Você deve chamar |
| load(property |
Coloca um comando na fila para carregar as propriedades especificadas do objeto. Você deve chamar |
| load(property |
Coloca um comando na fila para carregar as propriedades especificadas do objeto. Você deve chamar |
| pause |
Coloca em pausa a proteção da folha de cálculo para o objeto de folha de cálculo especificado para o utilizador na sessão atual. Este método não faz nada se a proteção da folha de cálculo não estiver ativada ou já estiver em pausa. Se a palavra-passe estiver incorreta, este método gera um |
| protect(options, password) | Protege uma planilha. Falha se a folha de cálculo já tiver sido protegida. |
| resume |
Retoma a proteção da folha de cálculo para o objeto de folha de cálculo especificado para o utilizador numa determinada sessão. A proteção da folha de cálculo tem de ser colocada em pausa para que este método funcione. Se a proteção da folha de cálculo não estiver em pausa, este método não alterará o estado de proteção da folha de cálculo. |
| set |
Altera a palavra-passe associada ao |
| toJSON() | Substitui o método JavaScript |
| unprotect(password) | Desprotege uma planilha. |
| update |
Altere as opções de proteção da folha de cálculo associadas ao |
Detalhes da propriedade
allowEditRanges
Especifica o AllowEditRangeCollection objeto encontrado nesta folha de cálculo. Esta é uma coleção de AllowEditRange objetos, que funcionam com propriedades de proteção de folhas de cálculo. Quando a proteção da folha de cálculo está ativada, um AllowEditRange objeto pode ser utilizado para permitir a edição de um intervalo específico, mantendo a proteção no resto da folha de cálculo.
readonly allowEditRanges: Excel.AllowEditRangeCollection;Valor da propriedade
Comentários
canPauseProtection
Especifica se a proteção pode ser colocada em pausa para esta folha de cálculo.
readonly canPauseProtection: boolean;Valor da propriedade
boolean
Comentários
context
O contexto do pedido associado ao objeto . Esta ação liga o processo do suplemento ao processo da aplicação anfitriã do Office.
context: RequestContext;Valor da propriedade
isPasswordProtected
Especifica se a folha está protegida por palavra-passe.
readonly isPasswordProtected: boolean;Valor da propriedade
boolean
Comentários
isPaused
Especifica se a proteção da folha de cálculo está em pausa.
readonly isPaused: boolean;Valor da propriedade
boolean
Comentários
options
Especifica as opções de proteção para a folha de cálculo.
readonly options: Excel.WorksheetProtectionOptions;Valor da propriedade
Comentários
protected
Especifica se a folha de cálculo está protegida.
readonly protected: boolean;Valor da propriedade
boolean
Comentários
savedOptions
Especifica as opções de proteção guardadas na folha de cálculo. Esta ação irá devolver o mesmo WorksheetProtectionOptions objeto, independentemente do estado de proteção da folha de cálculo.
readonly savedOptions: Excel.WorksheetProtectionOptions;Valor da propriedade
Comentários
Detalhes do método
checkPassword(password)
Especifica se a palavra-passe pode ser utilizada para desbloquear a proteção da folha de cálculo. Este método não altera o estado de proteção da folha de cálculo. Se for introduzida uma palavra-passe, mas não for necessária nenhuma palavra-passe para desbloquear a proteção da folha de cálculo, este método devolverá false.
checkPassword(password?: string): OfficeExtension.ClientResult<boolean>;Parâmetros
- password
-
string
A palavra-passe a marcar na folha de cálculo protegida.
Retornos
OfficeExtension.ClientResult<boolean>
Devolve true se a palavra-passe puder ser utilizada para desbloquear a proteção da folha de cálculo. Caso contrário, devolve false.
Comentários
load(options)
Coloca um comando na fila para carregar as propriedades especificadas do objeto. Você deve chamar context.sync() antes de ler as propriedades.
load(options?: Excel.Interfaces.WorksheetProtectionLoadOptions): Excel.WorksheetProtection;Parâmetros
Fornece opções para as propriedades do objeto a carregar.
Retornos
load(propertyNames)
Coloca um comando na fila para carregar as propriedades especificadas do objeto. Você deve chamar context.sync() antes de ler as propriedades.
load(propertyNames?: string | string[]): Excel.WorksheetProtection;Parâmetros
- propertyNames
-
string | string[]
Uma cadeia delimitada por vírgulas ou uma matriz de cadeias que especificam as propriedades a carregar.
Retornos
load(propertyNamesAndPaths)
Coloca um comando na fila para carregar as propriedades especificadas do objeto. Você deve chamar context.sync() antes de ler as propriedades.
load(propertyNamesAndPaths?: {
select?: string;
expand?: string;
}): Excel.WorksheetProtection;Parâmetros
- propertyNamesAndPaths
-
{ select?: string; expand?: string; }
propertyNamesAndPaths.select é uma cadeia delimitada por vírgulas que especifica as propriedades a carregar e propertyNamesAndPaths.expand é uma cadeia delimitada por vírgulas que especifica as propriedades de navegação a carregar.
Retornos
pauseProtection(password)
Coloca em pausa a proteção da folha de cálculo para o objeto de folha de cálculo especificado para o utilizador na sessão atual. Este método não faz nada se a proteção da folha de cálculo não estiver ativada ou já estiver em pausa. Se a palavra-passe estiver incorreta, este método gera um InvalidArgument erro e não interrompe a proteção. Este método não altera o estado de proteção se a proteção da folha de cálculo não estiver ativada ou já estiver em pausa.
pauseProtection(password?: string): void;Parâmetros
- password
-
string
A palavra-passe associada à folha de cálculo protegida.
Retornos
void
Comentários
protect(options, password)
Protege uma planilha. Falha se a folha de cálculo já tiver sido protegida.
protect(options?: Excel.WorksheetProtectionOptions, password?: string): void;Parâmetros
- options
- Excel.WorksheetProtectionOptions
Opcional. Opções de proteção da planilha.
- password
-
string
Opcional. Palavra-passe de proteção de folha.
Retornos
void
Comentários
[ Conjunto de API: ExcelApi 1.2 para opções; 1,7 para palavra-passe ]
Exemplos
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/50-workbook/data-protection.yaml
let password = await passwordHandler();
passwordHelper(password);
await Excel.run(async (context) => {
let activeSheet = context.workbook.worksheets.getActiveWorksheet();
activeSheet.load("protection/protected");
await context.sync();
if (!activeSheet.protection.protected) {
activeSheet.protection.protect(null, password);
}
});
resumeProtection()
Retoma a proteção da folha de cálculo para o objeto de folha de cálculo especificado para o utilizador numa determinada sessão. A proteção da folha de cálculo tem de ser colocada em pausa para que este método funcione. Se a proteção da folha de cálculo não estiver em pausa, este método não alterará o estado de proteção da folha de cálculo.
resumeProtection(): void;Retornos
void
Comentários
setPassword(password)
Altera a palavra-passe associada ao WorksheetProtection objeto. Definir a palavra-passe como uma cadeia vazia ("") ou removerá null a proteção por palavra-passe do WorksheetProtection objeto. A proteção da folha de cálculo tem de estar ativada e colocada em pausa para que este método funcione corretamente. Se a proteção da folha de cálculo estiver desativada, este método gera um InvalidOperation erro e não altera a palavra-passe. Se a proteção da folha de cálculo estiver ativada e não estiver em pausa, este método gera um AccessDenied erro e não altera a palavra-passe.
setPassword(password?: string): void;Parâmetros
- password
-
string
A palavra-passe associada ao WorksheetProtection objeto.
Retornos
void
Comentários
toJSON()
Substitui o método JavaScript toJSON() para fornecer uma saída mais útil quando um objeto de API é transmitido para JSON.stringify(). (JSON.stringifypor sua vez, chama o toJSON método do objeto que lhe é transmitido.) Enquanto o objeto original Excel.WorksheetProtection é um objeto de API, o toJSON método devolve um objeto JavaScript simples (escrito como Excel.Interfaces.WorksheetProtectionData) que contém cópias rasas de quaisquer propriedades subordinadas carregadas do objeto original.
toJSON(): Excel.Interfaces.WorksheetProtectionData;Retornos
unprotect(password)
Desprotege uma planilha.
unprotect(password?: string): void;Parâmetros
- password
-
string
Palavra-passe de proteção de folha.
Retornos
void
Comentários
[ Conjunto de API: ExcelApi 1.7 para palavra-passe ]
Exemplos
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/50-workbook/data-protection.yaml
let password = await passwordHandler();
passwordHelper(password);
await Excel.run(async (context) => {
let activeSheet = context.workbook.worksheets.getActiveWorksheet();
activeSheet.protection.unprotect(password);
});
updateOptions(options)
Altere as opções de proteção da folha de cálculo associadas ao WorksheetProtection objeto. A proteção da folha de cálculo tem de ser desativada ou colocada em pausa para que este método funcione corretamente. Se a proteção da folha de cálculo estiver ativada e não estiver em pausa, este método gera um AccessDenied erro e não altera as opções de proteção da folha de cálculo.
updateOptions(options: Excel.WorksheetProtectionOptions): void;Parâmetros
- options
- Excel.WorksheetProtectionOptions
A interface de opções associada ao WorksheetProtection objeto.
Retornos
void