Partilhar via


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 essa mensagem por meio da 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 ativa ou um ícone for desenhado, o parâmetro wParam será TRUE. Se uma barra de título ou ícone inativo for desenhado, wParam será FALSE.

lParam

Quando um estilo visual está ativo para essa janela, esse parâmetro não é usado.

Quando um estilo visual não está ativo para essa janela, esse parâmetro é um identificador para uma região de atualização opcional para a área não cliente da janela. Se esse parâmetro for definido como -1, DefWindowProc não repinta a área não cliente para refletir a alteração de estado.

Retornar valor

Tipo: LRESULT

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

Comentários

O processamento de mensagens relacionadas à área não cliente de uma janela padrão não é recomendado, pois 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 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 (inclui Windows.h)

Confira também

Referência

DefWindowProc

Conceitual

Windows