BCM_SETIMAGELIST mensagem

Atribui uma lista de imagens a um controle de botão. Você pode enviar essa mensagem explicitamente ou usar a macro Button_SetImageList .

Parâmetros

wParam

Não usado; deve ser zero.

lParam

Um ponteiro para uma estrutura BUTTON_IMAGELIST que contém informações da lista de imagens.

Valor retornado

Se a mensagem for bem-sucedida, ela retornará TRUE. Caso contrário, retornará FALSE.

Comentários

Observação

Para usar essa mensagem, você deve fornecer um manifesto especificando Comclt32.dll versão 6.0. Para obter mais informações sobre manifestos, consulte Habilitando estilos visuais.

A lista de imagens mencionada no membro himl da estrutura BUTTON_IMAGELIST deve conter uma única imagem a ser usada para todos os estados ou imagens individuais para cada estado. Os estados a seguir são definidos em vssym32.h.

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

Observe que PBS_STYLUSHOT é usado somente em tablets.

Cada valor é um índice para a imagem apropriada na lista de imagens. Se apenas uma imagem estiver presente, ela será usada para todos os estados. Se a lista de imagens contiver mais de uma imagem, cada índice corresponderá a um estado do botão. Se uma imagem não for fornecida para cada estado, nada será desenhado para esses estados sem imagens.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho	Commctrl.h