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

Article
03/06/2024

Récupère l’état de contrôle veuve et orpheline pour les paragraphes d’une plage.

Syntaxe

HRESULT GetWidowControl(
  long *pValue
);

Paramètres

pValue

Type : long*

Valeur tomBool qui indique l’état du contrôle veuve et orphelin. Il peut avoir l’une des valeurs suivantes.

Valeur	Signification
tomTrue	Empêche l’impression d’une veuve ou d’un orphelin
tomFalse	Permet l’impression d’une veuve ou d’un orphelin.
tomUndefined	La propriété de contrôle veuve n’est pas définie.

Valeur retournée

Type : HRESULT

Si ITextPara ::GetWidowControl 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.
CO_E_RELEASED	L’objet de mise en forme de paragraphe est attaché à une plage qui a été supprimée.

Remarques

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

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