messaggio STM_SETIMAGE
Un'applicazione invia un messaggio STM_SETIMAGE per associare una nuova immagine a un controllo statico.
Parametri
-
wParam
-
Specifica il tipo di immagine da associare al controllo statico. Questo parametro può essere uno dei valori seguenti:
Valore Significato - IMAGE_BITMAP
Bitmap. - IMAGE_CURSOR
Cursore. - IMAGE_ENHMETAFILE
Metafile avanzato. - IMAGE_ICON
Icona. -
lParam
-
Gestire l'immagine da associare al controllo statico.
Valore restituito
Il valore restituito è un handle per l'immagine precedentemente associata al controllo statico, se presente; in caso contrario, è NULL.
Commenti
Per associare un'immagine a un controllo statico, il controllo deve avere lo stile corretto. Nella tabella seguente viene illustrato lo stile necessario per ogni tipo di immagine.
| Tipo di immagine | Stile del controllo statico |
|---|---|
| IMAGE_BITMAP | SS_BITMAP |
| IMAGE_CURSOR | SS_ICON |
| IMAGE_ENHMETAFILE | SS_ENHMETAFILE |
| IMAGE_ICON | SS_ICON |
Importante
Nella versione 6 dei controlli Microsoft Win32, una bitmap passata a un controllo statico usando il messaggio STM_SETIMAGE era la stessa bitmap restituita da un messaggio di STM_SETIMAGE successivo. Il client è responsabile dell'eliminazione di qualsiasi bitmap inviata a un controllo statico.
Con Windows XP, se la bitmap passata nel messaggio STM_SETIMAGE contiene pixel con alfa diverso da zero, il controllo statico acquisisce una copia della bitmap. Questa bitmap copiata viene restituita dal messaggio STM_SETIMAGE successivo. Il codice client può tenere traccia in modo indipendente delle bitmap passate al controllo statico, ma se non controlla e rilascia le bitmap restituite da STM_SETIMAGE messaggi, le bitmap vengono perse.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato |
Windows Vista [solo app desktop] |
| Server minimo supportato |
Windows Server 2003 [solo app desktop] |
| Intestazione |
|