_WinAPI_GetSysColor
Beschreibung anzeigen in
Gibt die aktuelle Farbe des angegebenen Anzeigeelements zurück
#include <WinAPISysWin.au3>
_WinAPI_GetSysColor ( $iIndex )
Parameter
| $iIndex | Das Anzeigeelement, dessen Farbe abgefragt werden soll. Kann einer der folgenden Werte sein: $COLOR_3DDKSHADOW - Dunkler Schatten 3-dimensionaler Anzeigeelemente $COLOR_3DFACE - Vordergrundfarbe 3-dimensionaler Anzeigeelemente oder Hintergrundfarbe von Dialogboxen $COLOR_3DHIGHLIGHT - Hervorgehobene Farbe für 3-dimensionale Anzeigeelemente (für der Lichtquelle zugewandte Kanten) $COLOR_3DHILIGHT - Hervorgehobene Farbe für 3-dimensionale Anzeigeelemente (für der Lichtquelle zugewandte Kanten)) $COLOR_3DLIGHT - Beleuchtete Farbe für 3-dimensionale Anzeigeelemente (für der Lichtquelle zugewandte Kanten) $COLOR_3DSHADOW - Schattenfarbe für 3-dimensionale Anzeigeelemente (für der Lichtquelle gegenüberliegende Kanten) $COLOR_ACTIVEBORDER - Randfarbe des aktiven Fensters $COLOR_ACTIVECAPTION - Farbe der Titelleiste des aktiven Fensters Gibt die Farbe der linken Seite eines aktiven Fenstertitels an, falls ein Farbverlauf für Titelleisten eingestellt ist $COLOR_APPWORKSPACE - Hintergrundfarbe von MDI-Anwendungen (Mehrfach-Dokumentenansicht) $COLOR_BACKGROUND - Desktop-Hintergrundfarbe $COLOR_BTNFACE - Vordergrundfarbe 3-dimensionaler Anzeigeelemente oder Hintergrundfarbe von Dialogboxen $COLOR_BTNHIGHLIGHT - Hervorgehobene Farbe für 3-dimensionale Anzeigeelemente (für der Lichtquelle zugewandte Kanten) $COLOR_BTNHILIGHT - Hervorgehobene Farbe für 3-dimensionale Anzeigeelemente (für der Lichtquelle zugewandte Kanten) $COLOR_BTNSHADOW - Schattenfarbe für 3-dimensionale Anzeigeelemente (für der Lichtquelle gegenüberliegende Kanten) $COLOR_BTNTEXT - Textfarbe für Pushbuttons $COLOR_CAPTIONTEXT - Textfarbe für Beschriftungen, Größenauswahlboxen und Scroll-Leisten-Pfeilen $COLOR_DESKTOP - Desktop-Hintergrundfarbe $COLOR_GRADIENTACTIVECAPTION - Farbe der rechten Seite eines aktiven Fenstertitels $COLOR_ACTIVECAPTION gibt die Farbe der linken Seite an Um zu ermitteln, ob der Farbverlauf für Fenstertitel aktiviert ist, verwende den Parameter SPI_GETGRADIENTCAPTIONS mit der SystemParametersInfo-Funktion $COLOR_GRADIENTINACTIVECAPTION - Farbe der rechten Seite eines deaktivierten Fenstertitels $COLOR_INACTIVECAPTION gibt die Farbe der linken Seite an $COLOR_GRAYTEXT - Farbe eines ausgegrauten (deaktivierten) Textes. Dieser Farbwert wird auf 0 gesetzt, wenn der aktuelle Anzeigetreiber keine Graustufen unterstützt. $COLOR_HIGHLIGHT - Farbe ausgewählter Einträge (Items) $COLOR_HIGHLIGHTTEXT - Textfarbe ausgewählter Einträge $COLOR_HOTLIGHT - Farbe eine Hyperlinks oder eines per Hot-Tracking markierten Controls $COLOR_INACTIVEBORDER - Farbe eines inaktiven Fensterrahmens $COLOR_INACTIVECAPTION - Farbe der Beschriftung eines inaktiven Fensters Gibt die Farbe der linken Seite eines inaktiven Fenstertitels an, falls ein Farbverlauf für Titelleisten eingestellt ist $COLOR_INACTIVECAPTIONTEXT - Farbe des Textes eines inaktiven Fensters $COLOR_INFOBK - Hintergrundfarbe für Tooltips $COLOR_INFOTEXT - Textfarbe für Tooltips $COLOR_MENU - Menü-Hintergrundfarbe $COLOR_MENUHILIGHT - Farbe, die benutzt wird, um einen Menüeintrag hervorzuheben (wenn der flache Stil eingestellt ist). Der markierte Menüeintrag ist mit der Farbe $COLOR_HIGHLIGHT umrandet. Windows 2000: Dieser Wert wird nicht unterstützt. $COLOR_MENUBAR - Die Hintergrundfarbe einer Menüleiste, wenn der flache Stil eingestellt ist. Abweichend davon liefert $COLOR_MENU die Hintergrundfarbe des aufklappenden Menüs. Windows 2000: Dieser Wert wird nicht unterstützt. $COLOR_MENUTEXT - Farbe des Menütextes $COLOR_SCROLLBAR - Grauzone (Hintergrund) einer Scroll-Leiste $COLOR_WINDOW - Farbe des Fensterhintergrundes $COLOR_WINDOWFRAME - Farbe des Fensterrahmens $COLOR_WINDOWTEXT - Farbe des Fenstertextes |
Rückgabewert
Gibt die Rot-, Grün- und Blau-Farbwert (RGB) des angegebenen Anzeigeelements zurückBemerkungen
Oben genannte Konstanten benötigen #include <WindowsConstants.au3>
Falls der $iIndex Parameter außerhalb des Bereichs ist, ist der Rückgabewert 0. Da 0 jedoch auch ein gültiger RGB Wert ist, sollte man GetSysColor nicht verwenden um festzustellen, ob eine Systemfarbe durch die aktuelle Plattform unterstützt wird. Statt sollte man die GetSysColorBrush Funkion verwenden, welche NULL zurückgibt falls die Farbe nicht unterstützt wird.
Verwandte Funktionen
Siehe auch
Suche nach GetSysColor in der MSDN Bibliothek.
Beispiel
#include <GUIConstantsEx.au3>
#include <WinAPISysWin.au3>
#include <WindowsConstants.au3>
Example()
Func Example()
Local $aElements[2] = [$COLOR_ACTIVECAPTION, $COLOR_GRADIENTACTIVECAPTION]
; Rot und Gelb
Local $aColors[2] = [255, 65535], $aSaveColors[2]
GUICreate("Meine GUI", 300, 200)
$aSaveColors[0] = _WinAPI_GetSysColor($COLOR_ACTIVECAPTION)
$aSaveColors[1] = _WinAPI_GetSysColor($COLOR_GRADIENTACTIVECAPTION)
_WinAPI_SetSysColors($aElements, $aColors)
GUISetState(@SW_SHOW)
While 1
Switch GUIGetMsg()
Case $GUI_EVENT_CLOSE
ExitLoop
EndSwitch
WEnd
GUIDelete()
_WinAPI_SetSysColors($aElements, $aSaveColors)
Exit
EndFunc ;==>Example