Metodo ITextFont::GetProtected (tom.h)

Articolo
03/05/2024

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