GetThemeSysColorBrush-Funktion (uxtheme.h)

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