ITextRange::SetFont-Methode (tom.h)

Legt die Zeichenattribute dieses Bereichs auf die attribute des angegebenen ITextFont-Objekts fest.

Syntax

HRESULT SetFont(
  [in] ITextFont *pFont
);

Parameter

[in] pFont

Typ: ITextFont*

Ein Schriftartobjekt mit dem gewünschten Zeichenformat.

Rückgabewert

Typ: HRESULT

Die -Methode gibt einen HRESULT-Wert zurück. Wenn die Methode erfolgreich ist, gibt sie S_OK zurück. Wenn die Methode fehlschlägt, gibt sie einen der folgenden Fehlercodes zurück. Weitere Informationen zu COM-Fehlercodes finden Sie unter Fehlerbehandlung in COM.

Rückgabecode	Beschreibung
Wert	Bedeutung
E_ACCESSDENIED	Text ist geschützt.
E_INVALIDARG	pFont ist NULL.
E_OUTOFMEMORY	Nicht genügend Arbeitsspeicher.

Hinweise

Verwenden Sie für gelegentliche Formatänderungen die ITextRange::SetFont-Methode . Um jedoch eine Reihe von Zeichenformatänderungen vorzunehmen, ist es effizienter, ein Schriftartduplikat zu verwenden. Dies liegt daran, dass jedes Mal, wenn Sie eine Anweisung wie range.font.bold = tomTrueausführen, ein Schriftartobjekt zugeordnet und freigegeben wird. Ein Schriftartduplikat kann jedoch einmal zugeordnet und mehrfach verwendet werden. Darüber hinaus können Sie das Schriftduplikat speichern, sie mit der Reset-Methode auf den Standard- oder nicht definierten Status zurücksetzen und ihr nach Bedarf Werte für Die Rich-Text-Verarbeitung zuordnen. Beispielcode, der die Verwendung von Schriftduplikaten veranschaulicht, finden Sie unter Verwenden eines Schriftduplikats.

Anforderungen

Anforderung	Wert
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

ITextRange

Referenz

Zurücksetzen

Textobjektmodell