Freigeben über


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