SetForegroundWindow

O SetForegroundWindow função coloca o thread que criado a janela especificada para o primeiro plano e ativa a janela. Entrada do teclado é direcionada para a janela, e várias dicas visuais são alteradas para o usuário. O sistema atribui uma ligeiramente maior prioridade para o segmento que criado a janela de primeiro plano do que para outros segmentos.

(BOOL SetForegroundWindow HWND  hWnd / / identificador para janela para trazer para primeiro plano);
 

Parâmetros

hWnd
Identificador para a janela que deve ser ativada e trazida para o primeiro plano.

Retornar valores

Se a janela foi trazida para o primeiro plano, o valor de retorno é diferente de zero.

Se a janela não foi trazida para o primeiro plano, o valor de retorno é zero.

Observações

A janela de primeiro plano é a janela na parte superior da ordem Z. Ele é a janela que o usuário está trabalhando. Em um ambiente multitarefa preemptiva, geralmente você deve deixar o controle usuário qual janela é a janela de primeiro plano.

Windows NT 5.0 e posterior: Um aplicativo não pode forçar uma janela para o primeiro plano, enquanto o usuário estiver trabalhando com outra janela. Em vez disso, SetForegroundWindow ativará a janela (consulte SetActiveWindow) e chamar o FlashWindowEx função para notificar o usuário.

Windows CE: O segmento que possui a janela não for dado um aumento de prioridade.

QuickInfo

nbsp; Windows &NT: requer a versão 3.1 ou posterior.
Windows:Requer o Windows 95 ou posterior.
Windows CE:Requer versão 1.0 ou posterior.
Cabeçalho:Declarado em WinUser. h.
Biblioteca de importação:Use user32.lib.

Ver também

Visão geral sobre Windows, funções de janela, FlashWindowEx, GetForegroundWindow, SetActiveWindow

Index