_WinAPI_GetIconInfo
Beschreibung anzeigen in
Ermittelt Informationen über das bestimmte Icon oder Cursor
#include <WinAPIIcons.au3>
_WinAPI_GetIconInfo ( $hIcon )
Parameter
| $hIcon | Handle zu dem Icon oder Cursor. Um Informationen eines Standard-Icons oder Cursors abzurufen, ist einer der folgenden Werte festzulegen: $OCR_APPSTARTING - Standard Pfeil und kleine Sanduhr Cursor $OCR_NORMAL - Standard Pfeil Cursor: IDC_ARROW in MSDN $OCR_CROSS - Fadenkreuz Cursor $OCR_HAND - Hand Cursor $OCR_HELP - Pfeil und Fragezeichen Cursor $OCR_IBEAM - I-Beam Cursor $OCR_NO - Durchgestrichener Kreis Cursor $OCR_SIZEALL - Vier-Spitziger Pfeil Cursor $OCR_SIZENESW - Doppel-Spitziger Pfeil Cursor zeigend nach NO und SW $OCR_SIZENS - Doppel-Spitziger Pfeil Cursor zeigend nach N und S $OCR_SIZENWSE - Doppel-Spitziger Pfeil Cursor zeigend nach NW und SO $OCR_SIZEWE - Doppel-Spitziger Pfeil Cursor zeigend nach W und O $OCR_UP - Vertikaler Pfeil Cursor ; IDC_UPARROW in MSDN $OCR_WAIT - Sanduhr Cursor |
| Da $IDC_* bereits für MouseGetCursor() definiert ist, muss $OCR_* trotz MSDN-Doku-Nennung verwendet werden. | |
| $IDI_APPLICATION - Anwendung Icon $IDI_ASTERISK - Asterisk Icon $IDI_EXCLAMATION - Ausrufezeichen Icon $IDI_HAND - Stopp-Zeichen Icon $IDI_QUESTION - Fragezeichen Icon $IDI_WINLOGO - Windows Logo Icon |
Rückgabewert
| Erfolg: | Array mit dem folgenden Format: $aIcon[0] - TRUE $aIcon[1] - TRUE steht für ein Icon, FALSE für einen Cursor $aIcon[2] - Gibt die X-Koordinate vom Hot Spot eines Cursor's an $aIcon[3] - Gibt die Y-Koordinate vom Hot Spot eines Cursor's an $aIcon[4] - Gibt die Bitmasken-Bitmap vom Icon an $aIcon[5] - Handle zur Farb-Bitmap des Icon's |
| Fehler: | Setzt das @error Flag auf ungleich null. Es ist _WinAPI_GetLastError() aufzurufen um erweiterte Fehlerinformationen zu erhalten. |
Bemerkungen
Diese Funktion erzeugt Bitmaps für die Bitmasken-Bitmap ($aIcon[4]) und Farb-Bitmap ($aIcon[5]).
Man muss die Bitmaps verwalten und sie löschen, wenn sie nicht mehr benötigt werden.
Siehe auch
Suche nach GetIconInfo in der MSDN Bibliothek.
Beispiel
#include <MsgBoxConstants.au3>
#include <WinAPIIcons.au3>
Example()
Func Example()
Local $aInfo, $sInfo = ""
$aInfo = _WinAPI_GetIconInfo($IDC_WAIT)
For $x = 0 To UBound($aInfo) - 1
$sInfo &= $aInfo[$x] & @CRLF
Next
MsgBox($MB_SYSTEMMODAL, "GetIconInfo", "Icon-Informationen: " & @CRLF & $sInfo)
EndFunc ;==>Example