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

Article
08/26/2023

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

Syntaxe

HRESULT SetProtected(
  [in] long Value
);

Paramètres

[in] Value

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.
tomToggle	Basculez l’état de la propriété Protected.
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.
E_ACCESSDENIED	L’accès en écriture est refusé.
E_OUTOFMEMORY	Mémoire insuffisante.

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 modifier le texte protégé, le client TOM doit tenter de désactiver la protection du texte à modifier. Le propriétaire du document peut autoriser cela. Par exemple, dans les contrôles d’édition enrichis, les tentatives de modification du texte protégé entraînent un EN_PROTECTED code de notification au créateur du document, qui peut alors 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