Método ITextFont::SetProtected (tom.h)

Artigo
03/02/2024

Define se os caracteres são protegidos contra tentativas de modificá-los.

Sintaxe

HRESULT SetProtected(
  [in] long Value
);

Parâmetros

[in] Value

Tipo: long

Um valor tomBool que pode ser um dos seguintes.

Valor	Significado
tomTrue	Os caracteres são protegidos.
tomFalse	Os caracteres não estão protegidos.
tomToggle	Alterne o estado da propriedade Protected.
tomUndefined	A propriedade Protected é indefinida.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Se o método falhar, ele retornará um dos seguintes códigos de erro COM. Para obter mais informações sobre códigos de erro COM, consulte Tratamento de erros em COM.

Código de retorno	Descrição
E_INVALIDARG	Argumento inválido.
CO_E_RELEASED	O objeto de fonte é anexado a um intervalo que foi excluído.
E_ACCESSDENIED	Acesso de gravação negado.
E_OUTOFMEMORY	Memória insuficiente.

Comentários

Em geral, os métodos TOM (Text Object Model) que tentam alterar a formatação ou o conteúdo de um intervalo falharão com E_ACCESSDENIED se qualquer parte desse intervalo estiver protegida ou se o documento for somente leitura. Para fazer uma alteração no texto protegido, o cliente TOM deve tentar desativar a proteção do texto a ser modificado. O proprietário do documento pode permitir que isso aconteça. Por exemplo, em controles de edição avançada, as tentativas de alterar o texto protegido resultam em um código de notificação EN_PROTECTED para o criador do documento, que, em seguida, pode recusar ou conceder permissão para a alteração. O criador é o cliente que criou um controle de edição avançada em janelas por meio da função CreateWindow ou do objeto ITextHost que chamou a função CreateTextServices para criar um controle de edição avançada sem janelas.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	tom.h
DLL	Msftedit.dll