Função FindWindowExW (winuser.h)
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 FindWindowExW(
[in, optional] HWND hWndParent,
[in, optional] HWND hWndChildAfter,
[in, optional] LPCWSTR lpszClass,
[in, optional] LPCWSTR 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 pesquisa 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: 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 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 para uma classe de menu. Para obter mais informações, confira 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.
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
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 no Windows 8.1) |
Confira também
Conceitual
Referência