Metodo ITextFont::SetProtected (tom.h)

Imposta se i caratteri sono protetti da tentativi di modificarli.

Sintassi

HRESULT SetProtected(
  [in] long Value
);

Parametri

[in] Value

Tipo: long

Valore tomBool che può essere uno dei seguenti.

Valore Significato
tomTrue I caratteri sono protetti.
tomFalse I caratteri non sono protetti.
tomToggle Attiva lo stato della proprietà Protected.
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.
E_ACCESSDENIED
Accesso in scrittura negato.
E_OUTOFMEMORY
Memoria insufficiente.

Commenti

In generale, i metodi Text Object Model (TOM) che tentano di modificare la formattazione o il contenuto di un intervallo avranno esito negativo con E_ACCESSDENIED se una parte di tale intervallo è protetta o se il documento è di sola lettura. 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 rich-edit con finestra 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

GetProtected

ITextFont

Altre risorse

Riferimento

Modello a oggetti testo