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.

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

Siehe auch

Konzept

ITextRange

Referenz

Zurücksetzen

Textobjektmodell