Metodo ITextFont::SetProtected (tom.h)

Articolo
03/02/2024

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