Clippingbereich

Ein Clippingbereich bezieht sich auf einen bestimmten Bereich auf dem Bildschirm, der für die UI-Automatisierung definiert und verwendet wird. Er kann für die bildbasierte Automatisierung verwendet werden, ist aber nicht darauf beschränkt. Sie können beispielsweise eine Click-Aktivität verwenden, um ein UI-Element anzugeben und einen Unterbereich des Elements zu bearbeiten, indem Sie z. B. auf „BottomRight“ des kleineren/größeren Clippingbereichs klicken.

Der Standard-Clippingbereich ist das gesamte UI-Element, das Sie angegeben haben. Er kann jedoch manipuliert und auf einen kleineren Bereich reduziert werden, um die Geschwindigkeit und Effizienz zu verbessern.

Einrichten einer Clippingregion

Die Eigenschaft Clippingbereich in klassischen UI-Automatisierungsaktivitäten ist unter der Eigenschaft Ziel verschachtelt und kann verwendet werden, um einen kleineren/größeren Bereich des UI-Elements festzulegen, das zur Laufzeit mithilfe der Selektor-Eigenschaft des Ziels gefunden oder direkt über die Element-Eigenschaft des Ziels bereitgestellt wird.

Dazu müssen Sie Werte für alle Koordinaten (Links, Oben, Rechts, Unten) eingeben und den Clippingbereich direkt bearbeiten.

Einschränkungen

Es gibt einige Unterschiede zwischen visuellem Debug-Feedback und tatsächlichen Roboteraktionen. Nehmen wir als Beispiel die klassische Aktivität Click.

Bei einer Clippingregion von (-10, -10, 0, 0) führt das Konfigurieren der Aktivität mit CursorPosition auf BottomRight dazu, dass die Klickaktion am Ursprung des Elements (0,0) ausgeführt wird.

Bei einem Clippingbereich von (0, 0, -10, -10) ähnelt das Ergebnis dem ersten, da der Code intern sortiert/verwechselt wird und die niedrigsten Zahlen auf der X- und Y-Achse verwechselt werden.

Für eine Clippingregion von (10, 10, -10, -10) erfolgt die Klickaktion genau (10,10) entfernt vom Ursprung des Elements (0,0). Dieselbe Sortierung von Clippingbereichswerten auf der X-Achse und separat auf der Y-Achse führt zu einer internen Clippingregion (-10, -10, 10, 10).

Obwohl die ersten beiden Koordinaten X, Y relativ zu TopLeft sein sollten, während die letzten beiden Koordinaten relativ zur BottomRight des Elements sein sollten. Dies ist jedoch nicht genau und alle vier Koordinaten sind relativ zum TopLeft des Elements.

Darüber hinaus liefert eine Konfiguration wie (0, 0, -10, -10) aufgrund interner Codesortierungswerte auf der X- und Y-Achse das gleiche Ergebnis wie eine Konfiguration (-10, -10, 0, 0).

Einrichten eines Clippingbereichs durch Übergeben eines Rechteckobjekts

Sie können einen Clippingbereich einrichten, indem Sie die klassische Aktivität Set Clipping Region verwenden.

Dazu müssen Sie die Eigenschaft Richtung auf RECHTECK festlegen und unter der Eigenschaft Region die Koordinaten in diesem Format eingeben: UiPath.Core.Region(New Rectangle(X,Y,Width,Height)).

Einrichten eines Clippingbereichs mit „Find Element“ oder „Find Image“

Der Clippingbereich kann so festgelegt werden, dass er nur das Element oder Bild abdeckt, das mithilfe der Aktivitäten Find Image oder Find Element gefunden wird.

Die Position des Elements oder Bilds wird identifiziert und die Region kann dann mit der Eigenschaft ÜBERSETZEN der Aktivität Set Clipping Region manipuliert werden.