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

Obtém se os caracteres estão protegidos contra tentativas de modificá-los.

Sintaxe

HRESULT GetProtected(
  long *pValue
);

Parâmetros

pValue

Tipo: long*

Um valor tomBool que pode ser um dos seguintes.

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.

Comentários

Em geral, os métodos TOM (Text Object Model) que tentam alterar a formatação ou o conteúdo de um intervalo falham 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

Confira também

Conceitual

CreateTextServices

Createwindow

EN_PROTECTED

ITextFont

Outros recursos

Referência

SetProtected

Modelo de objeto de texto