GetThemeSysColorBrush-Funktion (uxtheme.h)

Artikel
08/26/2023

Ruft einen Systemfarbpinsel ab.

Syntax

HBRUSH GetThemeSysColorBrush(
  [in] HTHEME hTheme,
  [in] int    iColorId
);

Parameter

[in] hTheme

Typ: HTHEME

Behandeln von Designdaten.

[in] iColorId

Typ: int

Der Wert vom Typ int , der die Anzahl der gewünschten Systemfarbe angibt. Kann einer der folgenden Werte sein.

Wert	Bedeutung
TMT_SCROLLBAR	Die Farbe von Bildlaufleisten.
TMT_BACKGROUND	Die Farbe des Hintergrunds.
TMT_ACTIVECAPTION	Die Farbe des Untertitel Bereichs in einem aktiven Fenster.
TMT_INACTIVECAPTION	Die Farbe des Untertitel Bereichs in einem inaktiven Fenster.
TMT_WINDOW	Die Farbe eines Fensters.
TMT_WINDOWFRAME	Die Farbe des Rahmens um ein Fenster.
TMT_MENUTEXT	Die Farbe des In einem Menü gezeichneten Texts.
TMT_WINDOWTEXT	Die Farbe des in einem Fenster gezeichneten Texts.
TMT_CAPTIONTEXT	Die Farbe des Texts, der im Untertitel Bereich eines aktiven Fensters gezeichnet wird.
TMT_ACTIVEBORDER	Die Farbe des Rahmens um ein aktives Fenster.
TMT_INACTIVEBORDER	Die Farbe des Rahmens um ein inaktives Fenster.
TMT_APPWORKSPACE	Die Farbe des Anwendungsarbeitsbereichs.
TMT_HIGHLIGHT	Die Farbe einer Hervorhebung.
TMT_HIGHLIGHTTEXT	Die Farbe des hervorgehobenen Texts.
TMT_BTNFACE	Die Farbe eines Schaltflächengesichts.
TMT_BTNSHADOW	Die Farbe des Schattens unter einer Schaltfläche.
TMT_GRAYTEXT	Die Farbe des abgeblendeten Texts.
TMT_BTNTEXT	Die Farbe des Texts, der in einer Schaltfläche enthalten ist.
TMT_INACTIVECAPTIONTEXT	Die Farbe des Texts im Untertitel Bereich eines inaktiven Fensters.
TMT_BTNHIGHLIGHT	Die Farbe der Hervorhebung um eine Schaltfläche.
TMT_DKSHADOW3D	Die Farbe dreidimensionaler dunkler Schatten.
TMT_LIGHT3D	Die Farbe dreidimensionaler Lichtbereiche.
TMT_INFOTEXT	Die Farbe des Informationstexts.
TMT_INFOBK	Die Farbe des Hintergrunds hinter Informationstext.
TMT_BUTTONALTERNATEFACE	Die Farbe der alternativen Vorderseite einer Schaltfläche.
TMT_HOTTRACKING	Die Farbe der Hervorhebung, die angewendet wird, wenn ein Benutzer die Maus über ein Steuerelement bewegt.
TMT_GRADIENTACTIVECAPTION	Die Farbverlaufsfarbe, die auf den Untertitel Bereich eines aktiven Fensters angewendet wird.
TMT_GRADIENTINACTIVECAPTION	Die Farbverlaufsfarbe, die auf den Untertitel Bereich eines inaktiven Fensters angewendet wird.
TMT_MENUHILIGHT	Die Farbe der Hervorhebung, die auf einem Menüelement gezeichnet wird, wenn der Benutzer die Maus darüber bewegt.
TMT_MENUBAR	Die Farbe der Menüleiste.

Rückgabewert

Typ: HBRUSH

Handle zum Pinsel von Daten.

Hinweise

Wenn das Designdatenhandle kein NULL-Handle ist, gibt GetThemeSysColorBrush den Pinsel zurück, der der angegebenen Farbe aus dem SysMetrics-Abschnitt des visuellen Stils entspricht. Wenn das Designdatenhandle NULL ist, gibt die Funktion den Pinsel zurück, der der globalen Systemfarbe entspricht.

Das von dieser Funktion zurückgegebene Pinselhandle sollte freigegeben werden, wenn es mithilfe von DeleteObject nicht mehr benötigt wird.

Anforderungen


Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	uxtheme.h
Bibliothek	UxTheme.lib
DLL	UxTheme.dll

Freigeben über