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

Article
08/26/2023

Obtient si les caractères sont protégés contre les tentatives de modification.

Syntaxe

HRESULT GetProtected(
  long *pValue
);

Paramètres

pValue

Type : long*

Valeur tomBool qui peut être l’une des suivantes.

Valeur	Signification
tomTrue	Les caractères sont protégés.
tomFalse	Les caractères ne sont pas protégés.
tomUndefined	La propriété Protected n’est pas définie.

Valeur retournée

Type : HRESULT

Si la méthode réussit, elle retourne S_OK. Si la méthode échoue, elle retourne l’un des codes d’erreur COM suivants. Pour plus d’informations sur les codes d’erreur COM, consultez Gestion des erreurs dans COM.

Code de retour	Description
E_INVALIDARG	Argument non valide.
CO_E_RELEASED	L’objet police est attaché à une plage qui a été supprimée.

Remarques

En général, les méthodes TOM (Text Object Model) qui tentent de modifier la mise en forme ou le contenu d’une plage échouent avec E_ACCESSDENIED si une partie de cette plage est protégée ou si le document est en lecture seule. Pour apporter une modification au texte protégé, le client TOM doit tenter de désactiver la protection du texte à modifier. Le propriétaire du document peut le permettre. Par exemple, dans les contrôles d’édition enrichis, les tentatives de modification de texte protégé entraînent un EN_PROTECTED code de notification au créateur du document, qui peut ensuite refuser ou accorder l’autorisation pour la modification. Le créateur est le client qui a créé un contrôle d’édition enrichi fenêtré via la fonction CreateWindow ou l’objet ITextHost qui a appelé la fonction CreateTextServices pour créer un contrôle d’édition enrichi sans fenêtre.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	tom.h
DLL	Msftedit.dll