クリッピング領域

クリッピング領域とは、UI 操作のオートメーションのために定義および使用される、画面上の特定の領域です。画像ベースのオートメーションなどに使用できます。たとえば、[クリック] アクティビティを使用して UI 要素を指定し、その要素のサブ領域を操作することができます (小さい/大きいクリッピング領域の BottomRight をクリックするなど)。

既定のクリッピング領域は、指定した UI 要素全体です。ただし、速度と効率を向上させるために、領域を操作して、より小さな領域を選択することができます。

クリッピング領域の設定

クラシック UI Automation アクティビティの [クリッピング領域] プロパティは [ターゲット] プロパティの下に入れ子になっています。これを使用し、実行時にターゲットの [セレクター] プロパティを使用して見つかった UI 要素のより小さい、または大きい領域を選択したり、ターゲットの [要素] プロパティで直接指定したりすることができます。

そのためには、すべての座標 (左、上、右、下) の値を入力して、クリッピング領域を直接操作する必要があります。

制限事項

視覚的なデバッグ フィードバックと実際のロボットの操作には、いくつかの違いがあります。従来の [クリック] アクティビティを例に考えてみましょう。

クリッピング領域が (-10,-10, 0, 0) の場合、[カーソルの位置] を [BottomRight] にしてアクティビティを設定すると、要素の原点 (0,0) でクリック操作が実行されます。

クリッピング領域が (0, 0, -10, -10) の場合、内部コードにより X 軸と Y 軸で最小の数値が並べ替えられ、切り替えられるため、最初の領域と同様の場所でクリック操作が実行されます。

クリッピング領域が (10, 10, -10, -10) の場合、クリック操作は要素の原点 (0,0) からちょうど (10,10) 離れた場所で行われます。クリッピング領域の値が X 軸と Y 軸で同じように並べ替えられるため、内部クリッピング領域 (-10、-10、10、10) でクリック操作が実行されます。

基本的には、最初の 2 つの座標 X、Y は TopLeft からの相対位置とし、最後の 2 つの座標は要素の BottomRight からの相対位置にする必要があります。ただし、正確には、4 つの座標はすべて要素の TopLeft からの相対位置です。

さらに、内部コードにより X 軸と Y 軸の値が並べ替えられるため、たとえば (0, 0, -10, -10) と設定しても、(-10, -10, 0, 0) と設定したのと同じことになります。

矩形オブジェクトを渡してクリッピング領域を設定する

クラシック アクティビティの [クリッピング領域を設定] を使用して、クリッピング領域を設定できます。

そのためには、[RECTANGLE] で [方向] プロパティを設定し、[領域] プロパティに UiPath.Core.Region(New Rectangle(X,Y,Width,Height)) の形式で座標を入力する必要があります。

[要素を探す] または [画像を探す] を使用してクリッピング領域を設定する

クリッピング領域は、[画像を探す] または [要素を探す] アクティビティを使用して見つかった要素または画像のみを対象とするように設定できます。

要素または画像の位置が特定され、[クリッピング領域を設定] アクティビティの [TRANSLATE] プロパティを使用して領域を操作できます。