Função FindWindowExA (winuser.h)

Artigo
03/04/2024

Recupera um identificador para uma janela cujo nome de classe e nome de janela correspondem às cadeias de caracteres especificadas. A função pesquisa janelas filho, começando com a que segue a janela filho especificada. Essa função não executa uma pesquisa que diferencia maiúsculas de minúsculas.

Sintaxe

HWND FindWindowExA(
  [in, optional] HWND   hWndParent,
  [in, optional] HWND   hWndChildAfter,
  [in, optional] LPCSTR lpszClass,
  [in, optional] LPCSTR lpszWindow
);

Parâmetros

[in, optional] hWndParent

Digite: HWND

Um identificador para a janela pai cujas janelas filho devem ser pesquisadas.

Se hwndParent for NULL, a função usará a janela da área de trabalho como a janela pai. A função pesquisa entre janelas que são janelas filho da área de trabalho.

Se hwndParent for HWND_MESSAGE, a função pesquisará todas as janelas somente mensagens.

[in, optional] hWndChildAfter

Digite: HWND

Um identificador de uma janela filho. A busca começa com a próxima janela filho na ordem Z. A janela filho deve ser uma janela filho direta de hwndParent, não apenas uma janela descendente.

Se hwndChildAfter for NULL, a pesquisa começará com a primeira janela filho de hwndParent.

Observe que, se hwndParent e hwndChildAfter forem NULL, a função pesquisará todas as janelas de nível superior e somente de mensagem.

[in, optional] lpszClass

Tipo: LPCSTR

O nome da classe ou um átomo de classe criado por uma chamada anterior para a função RegisterClass ou RegisterClassEx . O átomo deve ser colocado na palavra de baixa ordem de lpszClass; a palavra de alta ordem deve ser zero.

Se lpszClass for uma cadeia de caracteres, ela especificará o nome da classe de janela. O nome da classe pode ser qualquer nome registrado com RegisterClass ou RegisterClassEx, ou qualquer um dos nomes de classe de controle predefinidos ou pode ser MAKEINTATOM(0x8000). Neste último caso, 0x8000 é o átomo de uma classe de menu. Para obter mais informações, confira a seção Comentários deste tópico.

[in, optional] lpszWindow

Tipo: LPCSTR

O nome da janela (o título da janela). Se esse parâmetro for NULL, todos os nomes de janela corresponderão.

Retornar valor

Digite: HWND

Se a função for bem-sucedida, o valor retornado será um identificador para a janela que tem os nomes de classe e janela especificados.

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

Comentários

A função FindWindowEx pesquisa apenas janelas filho diretas. Ele não pesquisa outros descendentes.

Se o parâmetro lpszWindow não for NULL, FindWindowEx chamará a função GetWindowText para recuperar o nome da janela para comparação. Para obter uma descrição de um possível problema que pode surgir, consulte a seção Comentários de GetWindowText.

Um aplicativo pode chamar essa função da seguinte maneira.

FindWindowEx( NULL, NULL, MAKEINTATOM(0x8000), NULL );

Observe que 0x8000 é o átomo de uma classe de menu. Quando um aplicativo chama essa função, a função verifica se um menu de contexto está sendo exibido que o aplicativo criou.

Observação

O cabeçalho winuser.h define FindWindowEx como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

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]
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-1 (introduzido em Windows 8.1)