SetForegroundWindow

9/9/2008

Esta função coloca o segmento que criada a janela especificada para o primeiro plano e ativa a janela.

Syntax

BOOL SetForegroundWindow(
  HWND hWnd 
);

Parameters

• hWnd
  [no] Identificador para a janela que deve ser ativada e trazida para o primeiro plano. Para obter mais informações, consulte a seção " Comentários ".

Return Value

Nonzero indica que a janela foi trazida para o primeiro plano. Zero indica que a janela não foi colocada para o primeiro plano.

Remarks

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

O segmento que possui a janela não é fornecido um aumento prioridade.

Se a janela que está sendo definida como o primeiro plano estiver minimizada, a janela pode não estar visível para o usuário final. Para restaurar a janela para um estado visível, ShowWindow deve ser chamado.

Essa função não reativar o ativo último Propriedade janela Por padrão. Para garantir que o ativo último Propriedade janela é reativada, combinar os manipulador de janela com 0 x 01 usando o operador OR lógico. Por exemplo:

SetForegroundWindow((HWND)(((ULONG) hwnd) | 0x01) );

Chamando PeekMessage Antes de parte superior nível janela de um aplicativo é criada irá resultar na janela que está sendo criada de voltar de z-ordem. Você precisará chamar explicitamente SetForegroundWindow a apresentação a janela quando ela é criada após um chamar para PeekMessage. Se o aplicativo já tiver uma janela no primeiro plano, em seguida, a nova janela será criada no primeiro plano.

SetForegroundWindow Não deve ser chamado em janelas filho.

Requirements

See Also

Reference

GetForegroundWindow
SetActiveWindow