ITextPara::SetWidowControl-Methode (tom.h)

Steuert die Unterdrückung von Witwen und Waisen.

Syntax

HRESULT SetWidowControl(
  [in] long Value
);

Parameter

[in] Value

Typ: long

Ein tomBool-Wert, der die Unterdrückung von Witwen und Waisen steuert. Dies kann einer der folgenden möglichen Werte sein.

Wert	Bedeutung
tomTrue	Verhindert das Drucken von Witwen und Waisen.
tomFalse	Ermöglicht das Drucken von Witwen und Waisen.
TomToggle	Der Wert wird umgeschaltet.
tomUndefined	Keine Änderung.

Rückgabewert

Typ: HRESULT

Wenn ITextPara::SetWidowControl erfolgreich ist, wird S_OK zurückgegeben. Wenn die Methode fehlschlägt, gibt sie einen der folgenden COM-Fehlercodes zurück. Weitere Informationen zu COM-Fehlercodes finden Sie unter Fehlerbehandlung in COM.

Rückgabecode	Beschreibung
Wert	Bedeutung
E_INVALIDARG	Ungültiges Argument.
E_ACCESSDENIED	Der Schreibzugriff wird verweigert.
E_OUTOFMEMORY	Nicht genügend Arbeitsspeicher.
CO_E_RELEASED	Das Absatzformatierungsobjekt wird an einen gelöschten Bereich angefügt.

Hinweise

Diese Methode ist aus Gründen der Kompatibilität mit Microsoft Word enthalten. Sie hat keinen Einfluss darauf, wie das Rich-Edit-Steuerelement Text anzeigt.

Eine Witwe wird erstellt, wenn die letzte Zeile eines Absatzes oben auf einer Seite selbst gedruckt wird. Ein Verwaist ist, wenn die erste Zeile eines Absatzes am Unteren Rand einer Seite selbst gedruckt wird.

Anforderungen

Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	tom.h
DLL	Msftedit.dll

Siehe auch

Konzept

ITextPara

Referenz

Textobjektmodell