WM_QUERYDRAGICON mensagem

Enviado para uma janela minimizada (icônica). A janela está prestes a ser arrastada pelo usuário, mas não tem um ícone definido para sua classe. Um aplicativo pode retornar um identificador para um ícone ou cursor. O sistema exibe esse cursor ou ícone enquanto o usuário arrasta o ícone.

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

#define WM_QUERYDRAGICON                0x0037

Parâmetros

wParam

Este parâmetro não é usado.

lParam

Este parâmetro não é usado.

Retornar valor

Tipo: LRESULT

Um aplicativo deve retornar uma alça para um cursor ou ícone que o sistema deve exibir enquanto o usuário arrasta o ícone. O cursor ou ícone deve ser compatível com a resolução do driver de exibição. Se o aplicativo retornar NULL, o sistema exibirá o cursor padrão.

Comentários

Quando o usuário arrasta o ícone de uma janela sem um ícone de classe, o sistema substitui o ícone por um cursor padrão. Se o aplicativo exigir que um cursor diferente seja exibido durante a arrastar, ele deverá retornar um identificador para o cursor ou ícone compatível com a resolução do driver de exibição. Se um aplicativo retornar um identificador para um cursor de cor ou ícone, o sistema converterá o cursor ou o ícone em preto e branco. O aplicativo pode chamar a função LoadCursor ou LoadIcon para carregar um cursor ou ícone dos recursos em seu arquivo executável (.exe) e recuperar esse identificador.

Se um procedimento de caixa de diálogo manipular essa mensagem, ele deverá converter o valor retornado desejado em um BOOL e retornar o valor diretamente. O valor DWL_MSGRESULT definido pela função SetWindowLong é ignorado.

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

Loadcursor

Loadicon

Conceitual

Windows