BlueZone-Emulator-Methoden

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 4 Minuten Lesedauer

    • Mit den BlueZone-Emulator-Methoden können Sie Aufgaben im BlueZone-Emulator automatisieren. Sie können beispielsweise Text aus dem Emulatorbildschirm in Form einer Tabelle erfassen und den Text in eine Excel-Tabelle einfügen.

    Methoden auf Bildschirmebene

    GetFieldText

    Gibt den Text aus der von Ihnen angegebenen Zeile und Spalte zurück.
    Tabelle : 1. GetFieldText-Methodenparameter
    Parameter Beschreibung Eintragstyp des Datenports Datentyp Standardwert Obligatorisch? Notizen
    Zeile Zeilennummer im Emulator-Bildschirm. Daten ein Ganzzahl Keine Ja
    Spalte Spaltennummer im Emulator-Bildschirm. Daten ein Ganzzahl Keine Ja
    Zurück Gibt den Text aus der Zeile und Spalte zurück. Datenausgabe Zeichenfolge NA NA

    GetTextFromRect

    Gibt den Text aus einem angegebenen Bereich von Zeilen und Spalten zurück, die in einem rechteckigen Bereich auf dem Emulator-Bildschirm vorhanden sind. Die Abbildung zeigt einen rechteckigen Bereich auf dem Bildschirm und die Start- und Endzeile und -spalten.

    Rechteckiger Bereich auf einem Bildschirm.

    Tabelle : 2. Parameter der GetTextFromRect-Methode
    Parameter Beschreibung Eintragstyp des Datenports Datentyp Standardwert Obligatorisch? Notizen
    StartZeile Die Nummer der Zeile, die am Anfang des rechteckigen Bereichs vorhanden ist. Daten ein Ganzzahl NA Ja
    Startspalte Die Nummer der Spalte, die am Anfang des rechteckigen Bereichs vorhanden ist. Daten ein Ganzzahl NA Ja
    Endzeile Die Nummer der Zeile, die sich am Ende des rechteckigen Bereichs befindet. Daten ein Ganzzahl NA Ja
    Endspalte Die Nummer der Spalte, die am Ende des rechteckigen Bereichs vorhanden ist. Daten ein Ganzzahl NA Ja
    Zurück Gibt den Text zurück. Datenausgabe Zeichenfolge NA NA

    IstErstellt

    Überprüft, ob der Emulator-Bildschirm aktiv ist.
    Tabelle : 3. IsCreated-Methodenparameter
    Parameter Beschreibung Eintragstyp des Datenports Datentyp Standardwert Obligatorisch? Notizen
    AlleUntergeordneten abgleichen Parameter, mit dem die Methode den Emulatorbildschirm durch Abgleichen der untergeordneten Elemente finden kann. Daten ein Boolean Falsch Ja
    Warnung:
    Die Verwendung dieser Option kann die Ausführung der Methode verzögern.
    Zurück Gibt den booleschen Wert zurück, je nachdem, ob die Methode des Bildschirms aktiv ist. Datenausgabe Boolean NA NA

    SearchText

    Gibt die Spalte und Zeile zurück, in der sich der von Ihnen angegebene Text befindet.
    Tabelle : 4. SearchText-Methodenparameter
    Parameter Beschreibung Eintragstyp des Datenports Datentyp Standardwert Obligatorisch? Notizen
    Text Text, den die Methode durchsucht. Daten ein Zeichenfolge NA Ja Bei dem von Ihnen angegebenen Text wird zwischen Groß- und Kleinschreibung unterschieden.
    Zeile Zeilennummer, in der sich der angegebene Text befindet. Datenausgabe Ganzzahl NA NA Wenn der von Ihnen angegebene Text in mehreren Zeilen und Spalten vorkommt, gibt die Methode die erste Zeile und Spalte zurück, die den Text enthält.
    Spalte Spaltennummer, in der sich der angegebene Text befindet. Datenausgabe Ganzzahl NA NA Wenn der von Ihnen angegebene Text in mehreren Zeilen und Spalten vorkommt, gibt die Methode die erste Zeile und Spalte zurück, die den Text enthält.

    SendKeys

    Fügt Tastenanschläge ein, die Sie über die Tastatur des Emulators eingeben.

    Hinweis:
    Verwenden Sie die SetCursorPosition-Methode, bevor Sie diese Methode verwenden.
    Tabelle : 5. SendKeys-Methodenparameter
    Parameter Beschreibung Eintragstyp des Datenports Datentyp Standardwert Obligatorisch? Notizen
    Schlüssel Tastenanschläge, die Sie über Ihre Tastatur eingeben. Daten ein Zeichenfolge Keine Ja

    SendKeysSecure

    Sendet verschlüsselte Schlüssel an die Cursorposition, die Sie auf dem Emulator-Bildschirm angeben.

    Hinweis:
    Verwenden Sie die SetCursorPosition-Methode, bevor Sie diese Methode verwenden.
    Tabelle : 6. SendKeys-Methodenparameter
    Parameter Beschreibung Eintragstyp des Datenports Datentyp Standardwert Obligatorisch? Notizen
    Schlüssel Tastenanschläge, die Sie über Ihre Tastatur eingeben. Daten ein Gesicherte Zeichenfolge Keine Ja
    Tipp:
    Weitere Informationen zu den Tastenanschlägen für den BlueZone-Emulator finden Sie unter https://www3.rocketsoftware.com/bluezone/help/v50/en/bz/DISPLAY/OPTIONS/MF/MF_Key_Mapping.htm.

    SetCursorPosition

    Setzt den Cursor auf die angegebene Zeile und Spalte auf dem Emulatorbildschirm.
    Tabelle : 7. SetCursorPosition-Methodenparameter
    Parameter Beschreibung Eintragstyp des Datenports Datentyp Standardwert Obligatorisch? Notizen
    Zeile Option, um die Nummer der Zeile anzugeben, an der die Methode den Cursor setzt. Daten ein Ganzzahl NA NA
    Spalte Option, um die Nummer der Spalte anzugeben, auf die die Methode den Cursor setzt. Daten ein Ganzzahl NA NA

    SetFieldText

    Legt den Text in der angegebenen Zeile und Spalte fest, die Sie angeben.
    Tabelle : 8. SetCursorPosition-Methodenparameter
    Parameter Beschreibung Eintragstyp des Datenports Datentyp Standardwert Obligatorisch? Notizen
    Zeile Nummer der Zeile, in der Sie den Text festlegen möchten. Daten ein Ganzzahl Keine Ja Die Methode ersetzt ggf. vorhandenen Text.
    Spalte Nummer der Spalte, in der Sie den Text festlegen möchten. Daten ein Ganzzahl Keine Ja Die Methode ersetzt ggf. vorhandenen Text.

    WartenAufErstellen

    Wartet, bis der Emulatorbildschirm verfügbar wird.
    Tabelle : 9. Parameter der WaitForCreate-Methode
    Parameter Beschreibung Eintragstyp des Datenports Datentyp Standardwert Obligatorisch? Notizen
    timeoutInSeconds Der Methodenvorgang läuft nach der von Ihnen angegebenen Dauer ab. Daten ein Ganzzahl 30 Sekunden Ja
    AlleUntergeordneten abgleichen Entspricht den Elementen des Bildschirms, die Sie erfasst haben, falls vorhanden. Daten ein Boolean Falsch Ja
    Warnung:
    Die Verwendung dieser Option kann die Ausführung der Methode verzögern.
    Zurück Gibt den booleschen Wert zurück, der angibt, ob der Emulatorbildschirm verfügbar ist. Datenausgabe Boolean NA NA

    Methoden auf Elementebene

    GetAlsTable

    Gibt den Text im Element zurück, das Sie in einer Tabelle erfasst haben.
    Tabelle : 10. GetAsTable-Methodenparameter
    Parameter Beschreibung Eintragstyp des Datenports Datentyp Standardwert Obligatorisch? Notizen
    Zurück Gibt den Text im Element innerhalb einer Tabelle zurück. Datenausgabe Datentabelle NA NA

    GetText

    Gibt den Text im Element zurück, das Sie erfasst haben.
    Tabelle : 11. GetText-Methodenparameter
    Parameter Beschreibung Eintragstyp des Datenports Datentyp Standardwert Obligatorisch? Notizen
    Zurück Gibt den Text im Element zurück. Datenausgabe Zeichenfolge NA NA

    IstErstellt

    Gibt den booleschen Wert zurück, der angibt, ob das Element verfügbar ist.
    Tabelle : 12. IsCreated-Methodenparameter
    Parameter Beschreibung Eintragstyp des Datenports Datentyp Standardwert Obligatorisch? Notizen
    Zurück Gibt den booleschen Wert zurück, der angibt, ob das Element verfügbar ist. Datenausgabe Boolean NA NA

    Text festlegen

    Legt den von Ihnen angegebenen Text auf das Element fest.
    Tabelle : 13. IsCreated-Methodenparameter
    Parameter Beschreibung Eintragstyp des Datenports Datentyp Standardwert Obligatorisch? Notizen
    Text Text, den die Methode für das Element festlegt. Daten ein Zeichenfolge Keine Ja Die Methode ersetzt ggf. vorhandenen Text.

    WartenAufErstellen

    Wartet, bis das Element verfügbar wird.
    Tabelle : 14. Parameter der WaitForCreate-Methode
    Parameter Beschreibung Eintragstyp des Datenports Datentyp Standardwert Obligatorisch? Notizen
    timeoutInSeconds Der Methodenvorgang läuft nach der von Ihnen angegebenen Dauer ab. Daten ein Ganzzahl 30 Sekunden Ja
    Zurück Gibt den booleschen Wert zurück, der angibt, ob das Element verfügbar ist. Datenausgabe Boolean NA NA