mensaje de BCM_SETIMAGELIST

Asigna una lista de imágenes a un control de botón. Puede enviar este mensaje explícitamente o usar la macro Button_SetImageList .

Parámetros

wParam

No se utiliza; debe ser cero.

lParam

Puntero a una estructura de BUTTON_IMAGELIST que contiene información de lista de imágenes.

Valor devuelto

Si el mensaje se realiza correctamente, devuelve TRUE. De lo contrario, devuelve FALSE.

Comentarios

Nota

Para usar este mensaje, debe proporcionar un manifiesto que especifique Comclt32.dll versión 6.0. Para obtener más información sobre los manifiestos, consulte Habilitación de estilos visuales.

La lista de imágenes a la que se hace referencia en el miembro himl de la estructura de BUTTON_IMAGELIST debe contener una sola imagen que se usará para todos los estados o imágenes individuales para cada estado. Los siguientes estados se definen en vssym32.h.

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

Tenga en cuenta que PBS_STYLUSHOT solo se usa en equipos tablet.

Cada valor es un índice de la imagen adecuada en la lista de imágenes. Si solo hay una imagen presente, se usa para todos los estados. Si la lista de imágenes contiene más de una imagen, cada índice corresponde a un estado del botón. Si no se proporciona una imagen para cada estado, no se dibuja nada para esos estados sin imágenes.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado	Commctrl.h