Condividi tramite

messaggio di BCM_SETIMAGELIST

  • Articolo

Assegna un elenco di immagini a un controllo pulsante. È possibile inviare questo messaggio in modo esplicito o utilizzare la macro Button_SetImageList .

Parametri

wParam

Non utilizzato; deve essere zero.

lParam

Puntatore a una struttura BUTTON_IMAGELIST che contiene informazioni sull'elenco di immagini.

Valore restituito

Se il messaggio ha esito positivo, restituisce TRUE. In caso contrario, restituisce FALSE.

Commenti

Nota

Per usare questo messaggio, è necessario specificare un manifesto che specifica Comclt32.dll versione 6.0. Per altre informazioni sui manifesti, vedere Abilitazione degli stili di visualizzazione.

L'elenco di immagini a cui fa riferimento il membro himl della struttura BUTTON_IMAGELIST deve contenere una singola immagine da usare per tutti gli stati o singole immagini per ogni stato. Gli stati seguenti sono definiti in vssym32.h.

enum PUSHBUTTONSTATES {
    PBS_NORMAL = 1,
    PBS_HOT = 2,
    PBS_PRESSED = 3,
    PBS_DISABLED = 4,
    PBS_DEFAULTED = 5,
    PBS_STYLUSHOT = 6,
};

Si noti che PBS_STYLUSHOT viene usato solo nei computer tablet.

Ogni valore è un indice dell'immagine appropriata nell'elenco di immagini. Se è presente una sola immagine, viene usata per tutti gli stati. Se l'elenco di immagini contiene più immagini, ogni indice corrisponde a uno stato del pulsante. Se non viene fornita un'immagine per ogni stato, non viene disegnato nulla per tali stati senza immagini.

Requisiti

Requisito Valore
Client minimo supportato
 Windows Vista [solo app desktop]
Server minimo supportato
 Windows Server 2003 [solo app desktop]
Intestazione
Commctrl.h