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

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

Confira também

Conceitual

CreateTextServices

Createwindow

EN_PROTECTED

GetProtected

ITextFont

Outros recursos

Referência

Modelo de objeto de texto