Bild anklicken (Click Image)

UiPath.Core.Activities.ClickImage

Sucht in einem UI-Element nach einem Bild und klickt es an.

Wichtig:

Die Aktivität Double Click Image hat die gleiche Funktionalität wie die Aktivität Click Image . Der einzige Unterschied besteht darin, dass für die Aktivität Double Click Image der ClickType standardmäßig auf CLICK_DOUBLE festgelegtist, während für die Aktivität Click Image der ClickType standardmäßig auf festgelegt ist CLICK_SINGLE.

Eigenschaften

Allgemein

• BeiFehlerFortsetzen – Gibt an, ob die Automatisierung auch dann fortgesetzt werden soll, wenn die Aktivität einen Fehler ausgibt. Dieses Feld unterstützt nur boolesche Werte (True, False). Der Standardwert ist False. Wenn das Feld leer ist und ein Fehler ausgegeben wird, wird die Ausführung des Projekts angehalten. Wenn der Wert auf „True“ gesetzt ist, wird die Ausführung des Projekts ungeachtet eines Fehlers fortgesetzt.
  Hinweis: Wenn diese Aktivität in Try Catch enthalten ist und der Wert der Eigenschaft BeiFehlerFortsetzen auf „True“ gesetzt ist, wird kein Fehler beim Ausführen des Projekts aufgefangen.
• VerzögernNach (DelayAfter) - Verzögerungszeit (in Millisekunden) nach dem Ausführen der Aktivität. Die Standardzeit sind 300 Millisekunden.
• VerzögerungVorher (DelayBefore) - Verzögerungszeit (in Millisekunden), bevor die Aktivität irgendwelche Operationen ausführt. Die Standardzeit sind 200 Millisekunden.
• AnzeigeName (DisplayName) - Der Anzeigename der Aktivität.

Eingabe

• KlickTyp (ClickType) - Gibt die Art des Mausklicks (einfach, doppel, hoch, runter) bei der Simulation des Klickereignisses an.
• Bild.Richtigkeit (Image.Accuracy) - Eine Maßeinheit zwischen 0 und 1 zum Ausdruck der minimalen Ähnlichkeit zwischen dem gefundenen Bild und dem von Ihnen gesuchten Bild. Sinnvoll, wenn das gesuchte Bild sich nur leicht vom gefundenen Bild unterscheidet. Der Standardwert ist 0,8.
• Bild.Bild (Image.Image) - Ein vorhandenes Bild, nach dem gesucht werden soll. Das Feld unterstützt nur Variablen vom Typ Bild (Image).
• Bild.Profil – Ermöglicht es Ihnen, den Bilderkennungsalgorithmus zu ändern, den Sie verwenden möchten. Standard ist der klassische Algorithmus mit durchschnittlicher Geschwindigkeit und Ressourcenkosten. Erweitert kann auf Kosten von mehr Ressourcen präzisere Ergebnisse liefern. Standardmäßig ist dieses Feld auf Standard festgelegt.
• MausTaste (MouseButton) - Die Maustaste (links, rechts, Mitte), die für die Klickaktion verwendet wird. Standardmäßig ist die linke Maustaste ausgewählt.
• Target.ClippingRegion - Definiert das Ausschneide-Rechteck in Pixel im Verhältnis zum UIElement in folgenden Richtungen: links, oben, rechts, unten. Es unterstützt sowohl positive als auch negative Zahlen.
• Ziel.Element (Target.Element) - Verwendet die Variable UIElement, die von einer anderen Aktivität zurückgegeben wird. Die Eigenschaft kann nicht zusammen mit der Auswahleigenschaft verwendet werden. Dieses Feld unterstützt nur Variablen vom Typ UIElement.
• Ziel.Selektor (Target.Selector) - Texteigenschaft zum Suchen eines bestimmten UI-Elements, wenn die Aktivität ausgeführt wird. Die Eigenschaft ist genau genommen ein XML-Fragment, das Attribute des gesuchten GUI-Elements und einige übergeordnete Elemente spezifiziert.
• Timeout (Millisekunden) – Gibt an, wie lange (in Millisekunden) die Aktivität laufen muss, bevor der Fehler SelectorNotFoundException ausgegeben wird. Der Standardwert ist 30.000 Millisekunden (30 Sekunden).
• Target.WaitForReady – Warten Sie, bis das Ziel bereit ist, bevor Sie die Aktionen ausführen. Standardmäßig ist Interaktiv/Vollständig ausgewählt. Die folgenden Optionen sind verfügbar:
  • Keine (None) - Wartet ausschließlich auf das UI-Zielelement, bevor die Aktion ausgeführt wird. Sie können diese Option beispielsweise verwenden, wenn Sie nur Text einer Website abrufen oder eine bestimmte Schaltfläche anklicken möchten, ohne auf das Laden aller UI-Elemente warten zu müssen. Beachten Sie, dass dies ungewünschte Folgen haben kann, wenn die Schaltfläche von Elementen wie Skripten abhängt, die noch nicht geladen sind.
  • Interaktiv - Wartet, bis nur ein Teil der App geladen ist.
  • Vollständig - Wartet bis die gesamte App geladen ist.

Sonstiges

• Privat (Private) - Bei Auswahl werden die Werte von Variablen und Argumenten nicht mehr auf der Stufe Verbose protokolliert.

Optionen

• CursorPosition.OffsetX (CursorPosition.OffsetX) - Horizontale Verschiebung der Cursorposition entsprechend der im Feld Position ausgewählten Option.
• CursorPosition.OffsetY (CursorPosition.OffsetY) - Vertikale Verschiebung der Cursorposition entsprechend der im Feld Position ausgewählten Option.
• CursorPosition.Position (CursorPosition.Position) - Beschreibt den Startpunkt des Cursors, zuzüglich der Verschiebung durch die Eigenschaften OffsetX und OffsetY. Folgende Optionen sind verfügbar: ObenLinks (TopLeft), ObenRechts (TopRight), UntenLinks (BottomLeft), UntenRechts (BottomRight) und Mitte (Center). Standardmäßig ist Mitte (Center) ausgewählt.
• KeyModifiers (KeyModifiers) – Ermöglicht Ihnen das Hinzufügen eines Schlüsselmodifikators. Die folgenden Optionen sind verfügbar: Keine, Alt, Strg, Umschalt, Win. Die Standardoption ist Keine.
  Hinweis: KeyModifiers können nicht mit der Option SendWindowMessages verwendet werden. Beim Ausführen eines Workflows, der eine Aktivität mit dieser Kombination von Optionen enthält, wird kein Fehler ausgegeben.
• SendenFensterNachrichten (SendWindowMessages) - Bei Auswahl wird der Klick durch das Senden einer bestimmten Nachricht an die Ziel-Anwendung ausgeführt. Diese Eingabemethode ist die schnellste und kann im Hintergrund arbeiten. Standardmäßig ist diese Methode nicht ausgewählt. Ist das Auswahlfeld nicht ausgewählt, führt die Standardmethode den Klick über den Hardware-Treiber aus. Die Standardmethode ist die langsamste, kann nicht im Hintergrund arbeiten, ist aber mit allen Desktop-Apps kompatibel.

Beispiel für die Verwendung der Click Image- und Double Click Image-Aktivitäten

Sie können sehen, wie die Aktivitäten Click Image und Double Click Image in einem Beispiel verwendet werden, das mehrere Aktivitäten enthält.

Sie können das Beispiel hier überprüfen und herunterladen.