Função SetActiveWindow (winuser.h)

Artigo
08/28/2023

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)