OCR-Text anklicken (Click OCR Text)

UiPath.Core.Activities.ClickOCRText

Sucht in einem angezeigten UI-Element oder Bild nach einer gegebenen Zeichenfolge mithilfe der OCR-Technologie und klickt sie an. Standardmäßig wird die UiPath Screen OCR- Engine verwendet.

Wichtig:

Die Aktivität Double Click OCR Text hat die gleiche Funktionalität wie die Aktivität Click OCR Text . Der einzige Unterschied besteht darin, dass bei der Aktivität „Double Click OCR Text“ der ClickType standardmäßig auf CLICK\_Double festgelegt ist, während bei der Aktivität „Click OCR Text“ der ClickType ist standardmäßig auf CLICK\_SINGLE festgelegt.

Eigenschaften

Allgemein

• ContinueOnError - Specifies if the automation should continue even when the activity throws an error. This field only supports Boolean values (True, False). The default value is False. As a result, if the field is blank and an error is thrown, the execution of the project stops. If the value is set to True, the execution of the project continues regardless of any error.

  Hinweis:

  Wenn die Aktivität in Abfangen versuchen (Try Catch) enthalten ist und der Wert der Eigenschaft BeiFehlerFortfahren (ContinueOnError) auf Wahr (True) gesetzt ist, wird kein Fehler bei der Ausführung des Projekts abgefangen.

• 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. Standardmäßig ist der einfache Klick ausgewählt.
• MausTaste (MouseButton) - Die Maustaste (links, rechts, Mitte), die für die Klickaktion verwendet wird. Standardmäßig ist die linke Maustaste ausgewählt.
• Auftreten (Occurrence) - Wenn die Zeichenfolge im Textfeld öfter als ein Mal im angezeigten UI-Element erscheint, können Sie an dieser Stelle angeben, welches Auftreten des Textfelds angeklickt werden soll. Wenn die Zeichenfolge beispielsweise vier Mal erscheint und das erste Auftreten angeklickt werden soll, geben Sie 1 in dieses Feld ein. Der Standardwert ist 1.
• 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.
• Target.Timeout (milliseconds) - Gibt an, wie lange die Aktivität laufen muss, bevor der Fehler SelectorNotFoundException ausgegeben wird. Der Standardwert ist 30000 Millisekunden (30 Sekunden).
• Target.WaitForReady - Before performing the actions, wait for the target to become ready. By default, Interactive/Complete is selected. The following options are available:
  • 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.
• Text (Text) - Die Zeichenfolge, die angeklickt werden soll. Alle Zeichenfolgen müssen in Anführungsstriche gesetzt werden.

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 - Beschreibt den Startpunkt des Cursors, zuzüglich der Verschiebung durch die Eigenschaften OffsetX und OffsetY. Die folgenden Optionen sind verfügbar: ObenLinks, ObenRechts, UntenLinks, UntenRechts und Mitte. Die Standardoption ist Mitte.

• Die folgenden Optionen sind verfügbar: Keine, Alt, Strg, Umschalt, Win. Die Standardoption ist Keine.

  Hinweis:

  Zusatztasten können nicht mit der Option „FenstermeldungenSenden“ 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 langsamer, kann nicht im Hintergrund arbeiten, ist aber mit allen Desktop Apps kompatibel.