ITextFont::SetForeColor-Methode (tom.h)

Artikel
03/04/2024

Legt die Vordergrundfarbe (Text) fest.

Syntax

HRESULT SetForeColor(
  [in] long Value
);

Parameter

[in] Value

Typ: long

Die neue Vordergrundfarbe. Dies kann einer der folgenden Sein:

Wert	Bedeutung
Ein COLORREF-Wert .	Eine RGB-Farbe.
Ein von PALETTEINDEX zurückgegebener Wert	Ein Palettenindex.
tomUndefined	Keine Änderung.
tomAutoColor	Verwenden Sie die Standardfarbe des Vordergrunds.

Wenn Value eine RGB-Farbe enthält, generieren Sie die COLORREF mithilfe des RGB-Makros .

Rückgabewert

Typ: HRESULT

Wenn die Methode 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
E_INVALIDARG	Ungültiges Argument.
CO_E_RELEASED	Das Schriftartobjekt wird an einen gelöschten Bereich angefügt.
E_ACCESSDENIED	Der Schreibzugriff wird verweigert.
E_OUTOFMEMORY	Nicht genügend Arbeitsspeicher.

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