Compartilhar via


WM_GETICON mensagem

Enviado para uma janela para recuperar um identificador para o ícone grande ou pequeno associado a uma janela. O sistema exibe o ícone grande na caixa de diálogo ALT+TAB e o ícone pequeno na janela legenda.

Uma janela recebe essa mensagem por meio da função WindowProc.

#define WM_GETICON                      0x007F

Parâmetros

wParam

O tipo de ícone que está sendo recuperado. Esse parâmetro pode usar um dos valores a seguir.

Valor Significado
ICON_BIG
1
Recupere o ícone grande da janela.
ICON_SMALL
0
Recupere o ícone pequeno da janela.
ICON_SMALL2
2
Recupera o pequeno ícone fornecido pelo aplicativo. Se o aplicativo não fornecer um, o sistema usará o ícone gerado pelo sistema para essa janela.

 

lParam

O DPI do ícone que está sendo recuperado. Isso pode ser usado para fornecer ícones diferentes dependendo do tamanho do ícone.

Retornar valor

Tipo: HICON

O valor retornado é um identificador para o ícone grande ou pequeno, dependendo do valor de wParam. Quando um aplicativo recebe essa mensagem, ele pode retornar um identificador para um ícone grande ou pequeno ou passar a mensagem para a função DefWindowProc .

Comentários

Quando um aplicativo recebe essa mensagem, ele pode retornar um identificador para um ícone grande ou pequeno ou passar a mensagem para DefWindowProc.

DefWindowProc retorna um identificador para o ícone grande ou pequeno associado à janela, dependendo do valor de wParam.

Uma janela que não tem nenhum ícone definido explicitamente (com WM_SETICON) usa o ícone para a classe de janela registrada e, nesse caso, DefWindowProc retornará 0 para uma mensagem de WM_GETICON . Se o envio de uma mensagem WM_GETICON para uma janela retornar 0, tente chamar a função GetClassLongPtr para a janela. Se isso retornar 0, tente a função LoadIcon .

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho
Winuser.h (inclui Windows.h)

Confira também

Referência

DefWindowProc

WM_SETICON

Conceitual

Windows