WM_GETICON Nachricht

  • Artikel

Wird an ein Fenster gesendet, um ein Handle für das große oder kleine Symbol abzurufen, das einem Fenster zugeordnet ist. Das System zeigt das große Symbol im Dialogfeld ALT+TAB an, und das kleine Symbol im Fenster Untertitel.

Ein Fenster empfängt diese Meldung über seine WindowProc-Funktion .

#define WM_GETICON                      0x007F

Parameter

wParam

Der Typ des abzurufenden Symbols. Dieser Parameter kann einen der folgenden Werte annehmen.

Wert Bedeutung
ICON_BIG
1
 Rufen Sie das große Symbol für das Fenster ab.
ICON_SMALL
0
 Rufen Sie das kleine Symbol für das Fenster ab.
ICON_SMALL2
2
 Ruft das kleine Symbol ab, das von der Anwendung bereitgestellt wird. Wenn die Anwendung keines bereitstellt, verwendet das System das vom System generierte Symbol für dieses Fenster.

 

lParam

Der DPI-Wert des abzurufenden Symbols. Dies kann verwendet werden, um je nach Symbolgröße unterschiedliche Symbole bereitzustellen.

Rückgabewert

Typ: HICON

Der Rückgabewert ist je nach Wert von wParam ein Handle für das große oder kleine Symbol. Wenn eine Anwendung diese Nachricht empfängt, kann sie ein Handle an ein großes oder kleines Symbol zurückgeben oder die Nachricht an die DefWindowProc-Funktion übergeben.

Bemerkungen

Wenn eine Anwendung diese Nachricht empfängt, kann sie ein Handle an ein großes oder kleines Symbol zurückgeben oder die Nachricht an DefWindowProc übergeben.

DefWindowProc gibt je nach Wert von wParam ein Handle für das große oder kleine Symbol zurück, das dem Fenster zugeordnet ist.

Ein Fenster, in dem kein Explizites Symbol festgelegt ist (mit WM_SETICON), verwendet das Symbol für die registrierte Fensterklasse. In diesem Fall gibt DefWindowProc für eine WM_GETICON Nachricht 0 zurück. Wenn beim Senden einer WM_GETICON Nachricht an ein Fenster 0 zurückgegeben wird, versuchen Sie als Nächstes, die GetClassLongPtr-Funktion für das Fenster aufzurufen. Wenn 0 zurückgegeben wird, probieren Sie die LoadIcon-Funktion aus.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
 Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
 Windows 2000 Server [nur Desktop-Apps]
Header
Winuser.h (windows.h einschließen)

Siehe auch

Referenz

DefWindowProc

WM_SETICON

Konzept

Windows