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 |
|---|---|
|
Bedeutung |
|
Text ist geschützt. |
|
pFont ist NULL. |
|
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
Referenz