WM_NCACTIVATE mensagem

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

Uma janela recebe esta mensagem através da sua função WindowProc.

#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 uma barra de título ou ícone ativo for desenhado, o parâmetro wParam será TRUE. Se uma barra de título ou ícone inativo deve ser desenhado, wParam é FALSE.

lParam

Se esse parâmetro for definido como -1, DefWindowProc não repintará a área não cliente 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. Este parâmetro pode ser NULL se a janela que estava ativa anteriormente (ou vai ser ativada) é 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 prosseguir com o processamento padrão, ou deve retornar FALSE para evitar a alteração. Quando wParam é TRUE, o valor de retorno é ignorado.

Observações

O processamento de mensagens relacionadas à área não cliente de uma janela padrão não é recomendado, porque o aplicativo deve ser capaz de desenhar todas as partes necessárias da área não cliente para a janela. Se um aplicativo processar essa mensagem, ele deve retornar TRUE para direcionar o sistema para concluir a alteração da janela ativa. Se a janela é minimizada quando esta mensagem é recebida, o aplicativo deve 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.

Requerimentos

Requisito	Valor
Cliente mínimo suportado	Windows 2000 Professional [apenas aplicações de ambiente de trabalho]
Servidor mínimo suportado	Windows 2000 Server [apenas aplicações de ambiente de trabalho]
Cabeçalho	Winuser.h (inclui Windows.h)

Ver também

Referência

DefWindowProc

Conceptual

Mac OS