Condividi tramite


Metodo ITextFont::GetProtected (tom.h)

Ottiene se i caratteri sono protetti da tentativi di modificarli.

Sintassi

HRESULT GetProtected(
  long *pValue
);

Parametri

pValue

Tipo: long*

Valore tomBool che può essere uno dei seguenti.

Valore Significato
tomTrue I caratteri sono protetti.
tomFalse I caratteri non sono protetti.
tomUndefined La proprietà Protected non è definita.

Valore restituito

Tipo: HRESULT

Se il metodo ha esito positivo, restituisce S_OK. Se il metodo ha esito negativo, restituisce uno dei codici di errore COM seguenti. Per altre informazioni sui codici di errore COM, vedere Gestione degli errori in COM.

Codice restituito Descrizione
E_INVALIDARG
Argomento non valido.
CO_E_RELEASED
L'oggetto carattere è collegato a un intervallo eliminato.

Commenti

In generale, i metodi Text Object Model (TOM) che tentano di modificare la formattazione o il contenuto di un intervallo hanno esito negativo con E_ACCESSDENIED se una parte di tale intervallo è protetta o se il documento viene letto solo. Per apportare una modifica nel testo protetto, il client TOM deve tentare di disattivare la protezione del testo da modificare. Il proprietario del documento può consentire l'operazione. Ad esempio, nei controlli di modifica avanzati, tenta di modificare il testo protetto in un codice di notifica EN_PROTECTED al creatore del documento, che può quindi rifiutare o concedere l'autorizzazione per la modifica. L'autore è il client che ha creato un controllo di modifica avanzato finestrato tramite la funzione CreateWindow o l'oggetto ITextHost che ha chiamato la funzione CreateTextServices per creare un controllo di modifica avanzato senza finestre.

Requisiti

Requisito Valore
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione tom.h
DLL Msftedit.dll

Vedi anche

Informazioni concettuali

CreateTextServices

Createwindow

EN_PROTECTED

ITextFont

Altre risorse

Riferimento

SetProtected

Modello a oggetti testo