ITextPara::SetWidowControl-Methode (tom.h)

  • Artikel

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