> For the complete documentation index, see [llms.txt](https://docs.roboteasy.tech/studio/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.roboteasy.tech/studio/geral/obter-elemento-xpath-arvore-de-elementos.md).

# Obter Elemento Xpath Árvore de elementos

### Visão Geral

A **Árvore de Elementos** é uma ferramenta do Genesis que exibe a hierarquia completa das janelas e elementos do Windows em tempo real. Permite navegar pela árvore de componentes, inspecionar propriedades e copiar o **XPath** de qualquer elemento para uso em automações desktop.

<p align="center"><img src="/files/hD3nFdag3Qi6R00rEhue" alt=""></p>

<p align="center"> Janela <strong>Árvore de Elementos</strong> com a árvore do Windows à esquerda e o painel de propriedades à direita</p>

***

### Pré-requisitos

* Ambiente Windows
* Aplicação ou janela alvo aberta na máquina

***

### Como usar

#### Passo 1 — Abrir a Árvore de Elementos

Na barra superior do Genesis, clique no ícone de **três tracinhos** (menu) ao lado de **Perfil** e selecione **Árvore de Elementos**.

<p align="center"><img src="/files/lr6zBZMLNPSk98oalZH3" alt=""> </p>

<p align="center">Menu suspenso com as opções <strong>Árvore de Elementos</strong>, <strong>Gravador Web</strong> e <strong>Gravador Windows</strong></p>

#### Passo 2 — Localizar o elemento na árvore

A janela **Árvore de Elementos** abrirá exibindo a hierarquia completa de janelas abertas no Windows (Área de Trabalho, Barra de Tarefas e todas as janelas ativas).

Expanda os nós clicando nas setas (▸) e navegue até encontrar a janela ou elemento que deseja inspecionar.

#### Passo 3 — Inspecionar as propriedades

Clique no elemento desejado para selecioná-lo. O painel **Propriedades** à direita exibirá os dados do elemento, divididos em duas seções:

**Detalhes:**

* **Name** — nome do elemento
* **xPath** — caminho XPath do elemento na árvore
* **Class Name** — classe da UI Automation
* **Control Type** — tipo de controle (Window, Pane, Button, etc.)
* **Text** — texto visível
* **FrameworkId** — framework de UI (WPF, Win32, etc.)
* **AutomationId** — ID de automação
* **ProcessId** — ID do processo
* **Handle** — handle da janela

**Coordenadas:**

* **Posição X / Posição Y** — coordenadas do elemento na tela
* **Largura / Altura** — dimensões do elemento

#### Passo 4 — Copiar o XPath

Com o elemento selecionado, clique no botão **Copiar xPath** no canto inferior esquerdo da janela. O XPath será copiado para a área de transferência.

#### Passo 5 — Usar o XPath na rotina

Cole o XPath copiado no campo **Valor de busca** de um componente **Buscar Elementos** (com **Forma de Busca** = `XPath`) na sua rotina.

***

### Barra de menus

| Menu    | Função                                  |
| ------- | --------------------------------------- |
| Arquivo | Opções de arquivo relacionadas à árvore |
| Modo    | Alterna o modo de inspeção              |

***

### Controles da janela

| Controle           | Localização             | Função                                                             |
| ------------------ | ----------------------- | ------------------------------------------------------------------ |
| Ícone de atualizar | Arquivo > atualizar     | Atualiza a árvore com o estado atual das janelas abertas           |
| Copiar xPath       | Canto inferior esquerdo | Copia o XPath do elemento selecionado para a área de transferência |
| UIA3               | Arquivo > configurações | Indica a engine de UI Automation em uso (UIA3 é o padrão)          |

<figure><img src="/files/Ik6YPNt7idXEoU5vXHTv" alt=""><figcaption></figcaption></figure>

***

### Campos do painel de propriedades

#### Detalhes

| Campo        | Descrição                                                 |
| ------------ | --------------------------------------------------------- |
| Name         | Nome do elemento                                          |
| xPath        | Caminho XPath do elemento                                 |
| Class Name   | Classe da UI Automation                                   |
| Control Type | Tipo de controle do elemento (Window, Pane, Button, etc.) |
| Text         | Texto visível do elemento                                 |
| FrameworkId  | Framework de UI do elemento (WPF, Win32, UWP, etc.)       |
| AutomationId | Identificador de automação                                |
| ProcessId    | ID do processo ao qual o elemento pertence                |
| Handle       | Handle da janela                                          |

#### Coordenadas

| Campo     | Descrição                                 |
| --------- | ----------------------------------------- |
| Posição X | Coordenada horizontal do elemento na tela |
| Posição Y | Coordenada vertical do elemento na tela   |
| Largura   | Largura do elemento em pixels             |
| Altura    | Altura do elemento em pixels              |

***

### Observações e dicas

* 💡 Use a **Árvore de Elementos** quando precisar explorar a hierarquia completa de uma aplicação desktop — é útil para entender como os elementos estão organizados antes de montar a automação.
* 💡 Diferente do **Gravador Windows** (que captura elementos sob demanda por atalho), a **Árvore de Elementos** permite navegar livremente por toda a estrutura de janelas e elementos em uma visão hierárquica.
* 💡 Após copiar o XPath, cole-o diretamente no campo **Valor de busca** de um componente **Buscar Elementos** configurado com **Forma de Busca = XPath**.
* 💡 Os campos **AutomationId** e **Class Name** também podem ser usados como estratégia de busca alternativa ao XPath, caso o XPath esteja instável.
* ⚠️ Se a janela alvo for aberta ou fechada após abrir a Árvore de Elementos, atualize a árvore para refletir o estado atual.
* ⚠️ A Árvore de Elementos inspeciona elementos do **Windows** — para páginas web, use o **Gravador Web** ou XPath via DevTools do navegador.