Freigeben über


BM_SETIMAGE Nachricht

Ordnet der Schaltfläche ein neues Bild (Symbol oder Bitmap) zu.

Parameter

wParam

Der Typ des Bilds, das der Schaltfläche zugeordnet werden soll. Dieser Parameter kann einer der folgenden Werte sein:

  • IMAGE_BITMAP
  • IMAGE_ICON

lParam

Ein Handle (HICON oder HBITMAP) für das Bild, das der Schaltfläche zugeordnet werden soll.

Rückgabewert

Der Rückgabewert ist ein Handle für das Bild, das zuvor der Schaltfläche zugeordnet ist, sofern vorhanden. Andernfalls ist es NULL.

Bemerkungen

Die Darstellung von Text, Symbolen oder beidem in einem Schaltflächensteuerelement hängt von der BS_ICON und BS_BITMAP ab und davon, ob die BM_SETIMAGE Nachricht aufgerufen wird. Die möglichen Ergebnisse sind wie folgt:

BS_ICON oder BS_BITMAP Set? BM_SETIMAGE aufgerufen? Ergebnis
Ja Ja Nur Symbol anzeigen.
Nein Ja Symbol und Text anzeigen.
Ja Nein Nur Text anzeigen.
Nein Nein Nur Text anzeigen

Anforderungen

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

Siehe auch

BM_GETIMAGE