Skip to main content
Acessar Studio

Coordenadas de tela

Algumas ações do Roberty — especialmente as de mouse e automação de desktop — operam com base em coordenadas de tela: a posição exata, em pixels, de um ponto na sua tela. Este tutorial explica o que são essas coordenadas, como elas funcionam e como utilizá-las nas ações do seu robô.

O que são coordenadas de tela?​

Imagine que a sua tela é um mapa quadriculado. Cada quadradinho desse mapa é um pixel — a menor unidade de imagem que a tela pode exibir. Uma tela Full HD (1920 × 1080), por exemplo, tem 1.920 colunas e 1.080 linhas de pixels, totalizando mais de 2 milhões de pontos individuais.

Para identificar qualquer ponto nesse mapa, usamos um par de números chamado coordenada:

  • X — posição horizontal (da esquerda para a direita)
  • Y — posição vertical (de cima para baixo)

Uma coordenada é escrita como (X, Y). Por exemplo: (960, 540) indica o centro exato de uma tela Full HD.

Analogia com planilha

Pense como no Excel: a coluna representa o eixo X (horizontal) e a linha representa o eixo Y (vertical). Assim como a célula C5 identifica uma posição única na planilha, a coordenada (960, 540) identifica um ponto único na tela.

Como o sistema de coordenadas funciona​

O ponto de origem — coordenada (0, 0) — fica no canto superior esquerdo da tela. A partir daí:

  • Mover para a direita aumenta o valor de X
  • Mover para baixo aumenta o valor de Y
(0,0) ──────────────────► X
  │
  │
  │
  │
  ▼
  Y

Portanto:

  • O canto superior direito de uma tela Full HD é aproximadamente (1920, 0)
  • O canto inferior esquerdo é (0, 1080)
  • O canto inferior direito é (1920, 1080)
  • O centro da tela é (960, 540)

Para que servem as coordenadas no Roberty?​

As coordenadas são usadas nas ações de mouse e automação de desktop, quando o robô precisa mover o cursor ou clicar em uma posição específica da tela — por exemplo, em aplicativos que não são websites e não possuem seletores HTML.

Exemplos de uso:

  • Mover o mouse até um botão em um software instalado na máquina
  • Clicar em um ponto específico de uma imagem ou tela de sistema legado
  • Realizar um clique duplo em uma área delimitada
  • Fazer scroll em uma posição determinada

Coordenadas ou seletores: qual usar?​

SituaçãoUse
Automação de sites e sistemas webSeletor — mais estável e preciso
Automação de aplicativos desktop (sem seletor)Coordenadas
Ação de reconhecimento de imagemCoordenadas (retornadas pela própria ação)
Clique em posição fixa e previsível na telaCoordenadas
Atenção com coordenadas em web

Para automação de navegador, prefira sempre os seletores HTML. As coordenadas dependem da posição exata na tela e podem variar se o conteúdo da página mudar, a janela for redimensionada ou a resolução da tela for diferente.

Como descobrir as coordenadas de um ponto na tela​

Opção 1 — PowerToys (Microsoft)​

O PowerToys é uma ferramenta gratuita da Microsoft que inclui uma função de lupa de cor que exibe as coordenadas do cursor em tempo real.

  1. Baixe e instale o PowerToys.
  2. Abra o PowerToys e ative o Color Picker (Seletor de Cores).
  3. Pressione Win + Shift + C para abrir o seletor.
  4. Mova o cursor até o ponto desejado — as coordenadas (X, Y) são exibidas em tempo real.

Opção 2 — Paint (nativo do Windows)​

  1. Tire um print da tela com Print Screen (ou a tecla PrtSc).
  2. Abra o Paint e cole a imagem (Ctrl + V).
  3. Mova o cursor sobre o ponto desejado — o Paint exibe as coordenadas na barra de status, na parte inferior da janela.

Opção 3 — Verificar a resolução da tela​

Se precisar saber o tamanho total da sua tela (para calcular posições relativas):

  1. Clique com o botão direito na área de trabalho.
  2. Selecione Configurações de Exibição.
  3. Localize o campo Resolução da tela — ele exibe as dimensões em pixels (ex.: 1920 × 1080).

Dicas práticas​

Use coordenadas absolutas com cuidado. Se o robô for executado em máquinas com resoluções diferentes da sua, as coordenadas podem apontar para posições erradas. Sempre valide em um ambiente com a mesma resolução que será usada na produção.

Combine com ações de reconhecimento de imagem. Quando a posição de um elemento muda dinamicamente, considere usar as ações de Reconhecimento de Imagem para que o robô encontre o elemento visualmente e retorne as coordenadas automaticamente — sem precisar fixar um valor.

Anote as coordenadas em parâmetros. Se usar a mesma coordenada em vários pontos do robô, salve-a como um parâmetro do robô para facilitar ajustes futuros.

Próximos passos​