Função FindWindowExW (winuser.h)

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

Sintaxe

HWND FindWindowExW(
  [in, optional] HWND    hWndParent,
  [in, optional] HWND    hWndChildAfter,
  [in, optional] LPCWSTR lpszClass,
  [in, optional] LPCWSTR lpszWindow
);

Parâmetros

[in, optional] hWndParent

Tipo: 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 .

[in, optional] hWndChildAfter

Tipo: HWND

Um identificador para uma janela filho. A pesquisa 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 estiverem NULL, a função pesquisará todas as janelas de nível superior e somente de mensagem.

[in, optional] lpszClass

Tipo: LPCWSTR

O nome da classe ou um atom 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 especifica o nome da classe de janela. O nome da classe pode ser qualquer nome registrado com RegisterClass ou RegisterClassEx ou qualquer um dos nomes predefinidos da classe de controle ou pode ser MAKEINTATOM(0x8000). Neste último caso, 0x8000 é o átomo para uma classe de menu. Para obter mais informações, consulte a seção Comentários deste tópico.

[in, optional] lpszWindow

Tipo: LPCWSTR

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

Valor de retorno

Tipo: 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.

Observações

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 do 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.

Requisitos

Consulte também

Conceitual

EnumWindows

findWindow

GetClassName

getWindowText

de referência de

RegisterClass

RegisterClassEx

Windows