Méthode ITextPara::SetWidowControl (tom.h)

Contrôle la suppression des veuves et des orphelins.

Syntaxe

HRESULT SetWidowControl(
  [in] long Value
);

Paramètres

[in] Value

Type : long

Valeur tomBool qui contrôle la suppression des veuves et des orphelins. Il peut s’agir de l’une des valeurs possibles suivantes.

Valeur	Signification
tomTrue	Empêche l’impression des veuves et des orphelins.
tomFalse	Permet l’impression des veuves et des orphelins.
tomToggle	La valeur est activée.
tomUndefined	Aucune modification.

Valeur retournée

Type : HRESULT

Si ITextPara::SetWidowControl réussit, il 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
Valeur	Signification
E_INVALIDARG	Argument non valide.
E_ACCESSDENIED	L’accès en écriture est refusé.
E_OUTOFMEMORY	Mémoire insuffisante.
CO_E_RELEASED	L’objet de mise en forme de paragraphe est attaché à une plage qui a été supprimée.

Remarques

Cette méthode est incluse pour la compatibilité avec Microsoft Word ; elle n’affecte pas la façon dont le contrôle d’édition enrichie affiche le texte.

Une veuve est créée lorsque la dernière ligne d’un paragraphe est imprimée seule en haut d’une page. Un orphelin est lorsque la première ligne d’un paragraphe est imprimée par elle-même en bas d’une page.

Configuration requise

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

Voir aussi

Conceptuel

ITextPara

Référence

Modèle objet texte