Compartilhar via


WM_NCACTIVATE mensagem

Enviado para uma janela quando sua área nãocliente precisa ser alterada para indicar um estado ativo ou inativo.

Uma janela recebe essa mensagem por meio de sua funçãoWindowProc.

#define WM_NCACTIVATE                   0x0086

Parâmetros

wParam

Indica quando uma barra de título ou ícone precisa ser alterado para indicar um estado ativo ou inativo. Se um ícone ou barra de título ativo deve ser desenhado, o parâmetro wParam será TRUE. Se um ícone ou barra de título inativo for desenhado, wParam será FALSE.

lParam

Se esse parâmetro for definido como -1, DefWindowProc não reintizará a área nãocliente para refletir a alteração de estado.

Caso contrário, se wParam for TRUE, esse parâmetro será um identificador para a janela ativa anteriormente. Se wParam for FALSE, esse parâmetro será um identificador para a janela que será ativada. Esse parâmetro poderá ser NULL se a janela anteriormente ativa (ou que será ativada) for de outro aplicativo.

Valor de retorno

Tipo: LRESULT

Quando o parâmetro wParam é FALSE, um aplicativo deve retornar TRUE para indicar que o sistema deve continuar com o processamento padrão ou deve retornar FALSE para impedir a alteração. Quando wParam é TRUE, o valor retornado é ignorado.

Observações

Não é recomendável processar mensagens relacionadas à área nãocliente de uma janela padrão, pois o aplicativo deve ser capaz de desenhar todas as partes necessárias da área nãocliente para a janela. Se um aplicativo processar essa mensagem, ele deverá retornar TRUE para direcionar o sistema para concluir a alteração da janela ativa. Se a janela for minimizada quando essa mensagem for recebida, o aplicativo deverá passar a mensagem para a função DefWindowProc .

A função DefWindowProc desenha a barra de título ou o título do ícone em suas cores ativas quando o parâmetro wParam é TRUE e em suas cores inativas quando wParam é FALSE.

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 (inclua Windows.h)

Consulte também

Referência

DefWindowProc

Conceitual

Windows