# Marcar Caixa de Seleção

## CONFIGURAÇÃO

Para utilizar esse objeto é necessário configurar objeto de automação windows, ter em mãos as informações corretas e configurar os parâmetros desejados.

<figure><img src="https://1906991432-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABFcMeFxBJhKzVOwJbRE%2Fuploads%2F575lZcNO6UrAtw5F0xoV%2Fimage.png?alt=media&#x26;token=4d81abd2-fccf-4b69-a7b9-e1fb0fc1d816" alt=""><figcaption><p>Layout geral do objeto</p></figcaption></figure>

**Preenchendo o objeto:**

| Campo                                                   | Descritivo                                                                                                                                                                                                                                                       |
| ------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Título                                                  | É o nome do objeto e **não precisa ser alterado**, a menos que você queira identificá-lo para facilitar a localização dele no robô, por exemplo: "Marcar Caixa de Seleção - Banco de Dados".                                                                     |
| Nome identificador do objeto                            | É um identificador único do objeto e **não precisa ser alterado**, mas você pode renomear caso queira para localizá-lo mais facilmente quando for usá-lo em outros objetos. Apenas lembre-se que esse nome deve ser único e sem espaços ou caracteres especiais. |
| Selecionar objeto do tipo Automação Windows             | Selecionar a janela aberta com o Objeto **Abrir programa ou Selecionar Janela.**                                                                                                                                                                                 |
| Forma de Busca                                          | Definir a forma de busca do elemento.                                                                                                                                                                                                                            |
| XPath/Nome/Classe/ID de Automação                       | Caminho dentro da janela especificada.                                                                                                                                                                                                                           |
| Buscar apenas um / Buscar uma lista                     | Definir a opção de busca no campo.                                                                                                                                                                                                                               |
| Tempo máximo de espera (em segundos)                    | Tempo de espera para encontrar o campo.                                                                                                                                                                                                                          |
| Parar execução caso algo dê errado na busca do elemento | Caso o campo não seja localizado, o robô para a execução.                                                                                                                                                                                                        |
| Marcar caixa de seleção                                 | Marcar ou desmarcar caixa de seleção em uma janela no Windows.                                                                                                                                                                                                   |

{% hint style="warning" %}
O retorno do resultado do objeto está associado à seleção positiva (SIM) da caixa de "Marcar caixa de seleção". Em caso de seleção negativa (NÃO), o retorno será considerado falho, resultando em um erro subsequente.
{% endhint %}

## PRÉ-REQUISITOS

* Para utilizar o objeto corretamente é necessário configurar o objeto [Abrir Programa](https://docs.roboteasy.tech/studio/geral/objetos/windows/aplicacoes/abrir-programa) ou [Selecionar Janela](https://docs.roboteasy.tech/studio/geral/objetos/windows/aplicacoes/selecionar-janela) e ter em mãos as informações de "Forma de Busca" (Xpath...) da caixa de seleção que deseja marcar.

## CASOS DE USO

* Utilizar quando precisar marcar uma caixa de seleção em janela Windows.

## EXEMPLO

{% hint style="info" %}
No futuro será introduzido um exemplo do objeto.
{% endhint %}