segunda-feira, 22 de fevereiro de 2016

Aprenda a usar a função EnumWindows() da API do Windows para listar todas as janelas de alto-nível abertas no momento

A função EnumWindows() da API do Windows pode ser usada para listar todas as janelas de alto-nível abertas no momento (ainda que não visíveis na tela). Veja sua assinatura:

BOOL EnumWindows(          
  WNDENUMPROC lpEnumFunc,
  LPARAM lParam
);

Note que esta função requer um ponteiro para uma função de Callback a ser definida em nosso código Delphi. Podemos ainda usar o parâmetro lParam para passar uma referência a um determinada controle do formulário, tal como um TMemo ou TListBox. Veja a assinatura para a função de Callback:

BOOL CALLBACK EnumWindowsProc(          
  HWND hwnd,
  LPARAM lParam
);

Note que esta função de Callback é chamada para cada janela encontrada e nos permite acesso à janela sendo listada no momento por meio do parâmetro hwnd, que é um handle para a janela. Novamente podemos usar o parâmetro lParam para acessar o TMemo ou TListBox passado pela função EnumWindows.

Vamos ao código agora. Veja como listar todas as janelas de alto-nível ativas no momento. Note que vamos exibir apenas as janelas que contenham um título (remova esta condição caso queira listar todas):

// função de Callback usada para listar as fontes de
// uma determinada família de fontes
function EnumWindowsProc(Wnd: HWND; memo: TMemo): BOOL; stdcall;
const
  MyMaxName = 256;
  MyMaxText = 256;
var
  ClassName: string;
  WindowText: string;
begin
  // vamos obter o nome de classe da janela
  SetLength(ClassName, MyMaxName);
  SetLength(ClassName, GetClassName(Wnd, PChar(ClassName),
    MyMaxName));

  // vamos obter o título da janela
  SetLength(WindowText, MyMaxText);
  SetLength(WindowText, SendMessage(Wnd, WM_GETTEXT, MyMaxText,
    lParam(PChar(WindowText))));

  // vamos exibir apenas as janelas que contenham título
  if WindowText <> '' then
    begin
      memo.Lines.Add('Nome da classe: ' + ClassName + ' - Título: ' +
        WindowText + ' - Handle: ' + IntToStr(Wnd));
    end;

  // vamos passar para a próxima janela
  Result := True;
end;

procedure TForm1.Button1Click(Sender: TObject);
begin
  // vamos listar todas as janelas de alto-nível em um TMemo
  EnumWindows(@EnumWindowsProc, lParam(Memo1));
end;

Nenhum comentário:

Postar um comentário