Compartilhar via


Função SetActiveWindow (winuser.h)

Ativa uma janela. A janela deve ser anexada à fila de mensagens do thread de chamada.

Sintaxe

HWND SetActiveWindow(
  [in] HWND hWnd
);

Parâmetros

[in] hWnd

Digite: HWND

Um identificador para a janela de nível superior a ser ativada.

Valor retornado

Digite: HWND

Se a função for bem-sucedida, o valor retornado será o identificador para a janela que estava ativa anteriormente.

Se a função falhar, o valor retornado será NULL. Para obter informações de erro estendidas, chame GetLastError.

Comentários

A função SetActiveWindow ativa uma janela, mas não se o aplicativo estiver em segundo plano. A janela será colocada em primeiro plano (parte superior da Ordem Z) se seu aplicativo estiver em primeiro plano quando o sistema ativar a janela.

Se a janela identificada pelo parâmetro hWnd tiver sido criada pelo thread de chamada, a janela ativa status do thread de chamada será definida como hWnd. Caso contrário, a janela ativa status do thread de chamada será definida como NULL.

Requisitos

   
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]
Plataforma de Destino Windows
Cabeçalho winuser.h (inclua Windows.h)
Biblioteca User32.lib
DLL User32.dll
Conjunto de APIs ext-ms-win-ntuser-window-l1-1-4 (introduzido no Windows 10, versão 10.0.14393)

Confira também

Conceitual

GetActiveWindow

Entrada por teclado

Referência

Setforegroundwindow

WM_ACTIVATE