Região do Recorte

Uma região de recorte refere-se a uma área específica na tela que é definida e usada para Automação de interface gráfica. Pode ser usada para automação baseada em imagem, mas não se limita a ela. Por exemplo, você pode usar uma atividade Click para indicar um elemento de interface gráfica e operar em uma subregião do elemento, por exemplo, clicando no canto Inferior Direito da região de recorte menor/maior.

A região de recorte padrão é todo o elemento de interface gráfica que você indicou. No entanto, pode ser manipulado e reduzido para uma região menor para melhorar a velocidade e a eficiência.

Configuração de uma região de recorte

A propriedade RegiãoDeRecorte em atividades de Automação de interface gráfica clássica está aninhada na propriedade Destino e pode ser usada para estabelecer uma região menor/maior do elemento de interface gráfica encontrado no runtime usando a propriedade Seletor de Destino ou fornecida diretamente por meio da propriedade Elemento de Destino.

Para fazer isso, você precisa inserir valores para todas as coordenadas, (Esquerda, Topo, Direita, Inferior) e manipular a região de recorte diretamente.

Limitações

Há algumas diferenças entre o feedback de depuração visual e as ações reais dos robôs.Vamos pegar a atividade Clicar clássica como um exemplo.

Para uma região de recorte de (-10,-10, 0, 0), a configuração da atividade com PosiçãoDoCursor definida em InferiorDireita faz com que a ação de clique ocorra na origem do elemento (0,0).

Para uma região de recorte de (0, 0, -10, -10), o resultado é semelhante ao primeiro por causa da ordenação/mudança dos números mais baixos do código interno nos eixos X e Y.

Para uma região de recorte de (10, 10, -10, -10), a ação de clique ocorre exatamente (10,10) longe da origem do elemento (0,0). A mesma classificação de valores de região de recorte em X e separadamente no eixo Y resulta em uma região de recorte interna (-10, -10, 10, 10).

Basicamente, as duas primeiras coordenadas X, Y devem ser relativas a SuperiorEsquerda, enquanto as duas últimas coordenadas devem parecer estar relacionadas à InferiorDireita do elemento.No entanto, isso não é preciso e todas as quatro coordenadas são relativas à SuperiorEsquerda do elemento.

Além disso, devido aos valores de classificação de código internos nos eixos X e Y, uma configuração como (0, 0, -10, -10) produz o mesmo resultado que uma configuração (-10, -10, 0, 0).

Configuração de uma região de recorte passando um objeto retângular

Você pode configurar uma região de recorte usando a atividade clássica Set Clipping Region.

Para fazer isso, você precisa definir a propriedade Direção em RETÂNGULO e inserir na propriedade Região as coordenadas seguindo este formato:UiPath.Core.Region(New Rectangle(X,Y,Width,Height))

Configuração de uma região de recorte usando Localizar elemento ou Localizar imagem

A região de recorte pode ser definida para cobrir apenas o elemento ou imagem que é encontrado usando as atividades Localizar imagem ou Localizar elemento.

A posição do elemento ou imagem é identificada e a região pode ser manipulada usando a propriedade TRANSLATE da atividade Set Clipping Region.