Emulatormethoden für Rocket BlueZone
Verwenden Sie die Rocket BlueZone-Emulatormethoden, um verschiedene Automatisierungsaufgaben für den Rocket BlueZone-Emulator auszuführen.
Methoden auf Bildschirmebene
Verwenden Sie Methoden auf Bildschirmebene, um die Automatisierungsaufgaben auf dem Emulatorbildschirm auszuführen. Sie können beispielsweise einen Befehl auf dem Bildschirm simulieren oder Text vom Bildschirm abrufen.
GetFieldText
Gibt den Text zurück, den ein Feld enthält, nachdem es das Feld anhand der von Ihnen angegebenen Zeilen- und Spaltennummer identifiziert hat. Die von Ihnen angegebene Zeile und Spalte sind der Ausgangspunkt des Felds. Die Methode identifiziert das gesamte Feld und gibt dann den Text im Feld zurück. Im folgenden Beispiel: H Ist der erste Buchstabe und der Ausgangspunkt im Feld und Host-BS: Ist der vollständige Text im Feld.
| Parameter | Beschreibung | Datenport-Eintragstyp | Datentyp | Standardwert | Obligatorisch | Notizen |
|---|---|---|---|---|---|---|
| Zeile | Feldzeilennummer, die das Feld identifiziert. | Daten In | Ganzzahl | NA | Ja | |
| Spalte | Feldspaltennummer, die das Feld identifiziert. | Daten In | Ganzzahl | NA | Ja | |
| Zurück | Gibt den Text im Feld zurück. | Daten Aus | Zeichenfolge | NA | NA |
GetTextFromRect
Gibt den Text in allen Feldern eines rechteckigen Bereichs zurück, den Sie auf dem Bildschirm definieren. Sie definieren einen Bereich, indem Sie die Zeilen und Spaltennummern für den Anfang und das Ende angeben. Die Methode sucht und identifiziert das erste und das letzte Feld und gibt den gesamten Text in allen Feldern in diesem Bereich zurück. Das folgende Beispiel zeigt den von Ihnen definierten Bereich.
| Parameter | Beschreibung | Datenport-Eintragstyp | Datentyp | Standardwert | Obligatorisch | Notizen |
|---|---|---|---|---|---|---|
| StartRow | Zeilennummer, die das erste Zeichen des ersten Felds im rechteckigen Bereich angibt. | Daten In | Ganzzahl | NA | Ja | |
| Startspalte | Spaltennummer, die das erste Zeichen des ersten Felds im rechteckigen Bereich enthält. | Daten In | Ganzzahl | NA | Ja | |
| Eintritt | Zeilennummer, die das letzte Zeichen des letzten Felds im rechteckigen Bereich enthält. | Daten In | Ganzzahl | NA | Ja | |
| Endspalte | Spaltennummer, die das letzte Zeichen des letzten Felds im rechteckigen Bereich enthält. | Daten In | Ganzzahl | NA | Ja | |
| Zurück | Gibt den Text aus allen Feldern im rechteckigen Bereich zurück. | Daten Aus | Zeichenfolge | NA | NA |
Ist erstellt
Überprüft, ob der Emulatorbildschirm basierend auf der Bildschirmabgleichsregel vorhanden ist und Eingaben vom Anwender akzeptieren kann. Nach der Verifizierung gibt die Methode den entsprechenden booleschen Wert zurück.
| Parameter | Beschreibung | Datenport-Eintragstyp | Datentyp | Standardwert | Obligatorisch | Notizen |
|---|---|---|---|---|---|---|
| Übereinstimmungalle untergeordneten Elemente | Option zum Suchen des Emulatorbildschirms durch Abgleichen der von Ihnen erfassten untergeordneten Elemente. | Daten In | Boolean | Falsch | Ja |
Warnung:
Die Verwendung dieser Option kann die Methode verlangsamen. |
| Zurück | Gibt den booleschen Wert zurück, abhängig davon, ob der Emulatorbildschirm basierend auf der Bildschirmübereinstimmungsregel vorhanden ist und Eingaben vom Anwender akzeptieren kann. | Daten Aus | Boolean | NA | NA |
SearchText
Emulator , Die Methode gibt die Zeilen- und Spaltennummern des Startpunkts des Worts zurück Emulator Was ist E .| Parameter | Beschreibung | Datenport-Eintragstyp | Datentyp | Standardwert | Obligatorisch | Notizen |
|---|---|---|---|---|---|---|
| Text | Text, den die Methode durchsucht. | Daten In | Zeichenfolge | NA | Ja | Bei dem von Ihnen angegebenen Text wird die Groß-/Kleinschreibung je nach verwendetem Emulator unterschieden. |
| Zeile | Zeilennummer, die das erste Zeichen des von Ihnen angegebenen Texts enthält. | Daten Aus | Ganzzahl | NA | NA | Wenn der von Ihnen angegebene Text in mehreren Zeilen und Spalten auftritt, gibt die Methode die erste Zeile und Spalte zurück, die den Text enthalten. |
| Spalte | Spaltennummer, die das erste Zeichen des von Ihnen angegebenen Texts enthält. | Daten Aus | Ganzzahl | NA | NA | Wenn der von Ihnen angegebene Text in mehreren Zeilen und Spalten auftritt, gibt die Methode die erste Zeile und Spalte zurück, die den Text enthalten. |
SendKeys
Simuliert die Tastenanschläge, die Sie über die Tastatur an der Position des Mausgeräts auf dem Emulatorbildschirm eingeben. Sie können beispielsweise simulieren <enter> Tastenanschlag auf dem Bildschirm.
| Parameter | Beschreibung | Datenport-Eintragstyp | Datentyp | Standardwert | Obligatorisch | Notizen |
|---|---|---|---|---|---|---|
| Keys | Tastenanschläge, die Sie über Ihre Tastatur eingeben. | Daten In | Zeichenfolge | Keine | Ja |
Tipp:
Weitere Informationen zu den Tastenanschlägen finden Sie in der Dokumentation zum entsprechenden Terminal-Emulator. |
SendKeysSecure
Simuliert die Tastenanschläge, bei denen es sich um eine gesicherte Zeichenfolge an der Position des Mausgeräts auf dem Emulatorbildschirm handelt.
| Parameter | Beschreibung | Datenport-Eintragstyp | Datentyp | Standardwert | Obligatorisch | Notizen |
|---|---|---|---|---|---|---|
| Keys | Tastenanschläge, die Sie als gesicherte Zeichenfolge eingeben. | Daten In | Gesicherte Zeichenfolge | Keine | Ja |
Tipp:
Weitere Informationen zu den Tastenanschlägen finden Sie in der Dokumentation zum entsprechenden Terminal-Emulator. |
SetCursorPosition
Versucht, das Mausgerät an der von Ihnen angegebenen Zeilen- und Spaltennummer festzulegen.
| Parameter | Beschreibung | Datenport-Eintragstyp | Datentyp | Standardwert | Obligatorisch | Notizen |
|---|---|---|---|---|---|---|
| Zeile | Option zur Angabe der Anzahl der Zeile, basierend auf der die Methode versucht, das Mausgerät auf dem Bildschirm festzulegen. | Daten In | Ganzzahl | NA | NA | Die Zeilennummer muss positiv sein und innerhalb der Größe des Emulatorbildschirms liegen. Wenn die Bildschirmgröße beispielsweise 24X80 ist, ist der Höchstwert, den Sie für eine Zeile angeben können, 24. |
| Spalte | Option zur Angabe der Anzahl der Zeile, basierend auf der die Methode versucht, das Mausgerät auf dem Bildschirm festzulegen. | Daten In | Ganzzahl | NA | NA | Die Spaltennummer muss positiv sein und innerhalb der Größe des Emulatorbildschirms liegen. Wenn die Bildschirmgröße beispielsweise 24X80 ist, beträgt der Höchstwert, den Sie für eine Spalte angeben können, 80. |
Warten auf Erstellen
Wartet für die von Ihnen angegebene Dauer, während der Connector die Bildschirmabgleichsregel verwendet, um festzustellen, ob der Bildschirm vorhanden ist.
| Parameter | Beschreibung | Datenport-Eintragstyp | Datentyp | Standardwert | Obligatorisch | Notizen |
|---|---|---|---|---|---|---|
| ZeitüberschreitinSekunden | Option zur Angabe der Anzahl der Sekunden, für die die Methode wartet, während der Connector die Bildschirmabgleichsregel verwendet, um zu ermitteln, ob der Bildschirm vorhanden ist. | Daten In | Ganzzahl | 30 | Ja | |
| Übereinstimmungalle untergeordneten Elemente | Option zum Abgleichen aller erfassten Bildschirmelemente, um zu ermitteln, ob der Bildschirm vorhanden ist. | Daten In | Boolean | Falsch | Ja |
Warnung:
Die Verwendung dieser Option kann die Ausführung der Methode verzögern. |
| Zurück | Gibt den booleschen Wert basierend darauf zurück, ob der Emulatorbildschirm gefunden wurde. | Daten Aus | Boolean | NA | NA |
Methoden auf Elementebene
Methoden auf Elementebene führen Automatisierungsaufgaben für die Elemente des Emulatorbildschirms durch, die Sie über den Bildschirm Terminal Connector hinzufügen. Sie können ein Bildschirmelement als Feld oder Tabelle hinzufügen.
GetAsTable
Gibt den Text zurück, den Sie als Datentabellenobjekt erfasst haben. Verwenden Sie diese Methode, wenn Sie die Daten aus einem Bildschirm als Tabelle erfassen. Sie können die Methode jedoch auch für die Daten verwenden, die Sie als Feld erfassen. Informationen zum Erfassen der Daten als Tabelle finden Sie unter Konfigurieren Sie IBM Emulator für persönliche Kommunikation.
| Parameter | Beschreibung | Datenport-Eintragstyp | Datentyp | Standardwert | Obligatorisch | Notizen |
|---|---|---|---|---|---|---|
| Zurück | Gibt den erfassten Text vom Terminal-Bildschirm als Datentabellenobjekt zurück. | Daten Aus | Datentabelle | NA | NA | Um die Tabelle anzuzeigen, klicken Sie mit der rechten Maustaste auf den Parameter, und wählen Sie aus Vorschau Der Daten Anzeigen . |
Gettext
Gibt den Text in dem Feld zurück, den Sie über den Emulatorbildschirm erfasst haben. Wenn Sie diese Methode für eine von Ihnen erfasste Tabelle verwenden, wird der Text im ersten Feld des Rechtecks zurückgegeben.
| Parameter | Beschreibung | Datenport-Eintragstyp | Datentyp | Standardwert | Obligatorisch? | Notizen |
|---|---|---|---|---|---|---|
| Zurück | Gibt den Text aus dem erfassten Feld zurück. | Daten Aus | Zeichenfolge | NA | NA |
Ist erstellt
Entspricht den Regeln und überprüft, ob das erfasste Element vorhanden ist.
| Parameter | Beschreibung | Datenport-Eintragstyp | Datentyp | Standardwert | Obligatorisch | Notizen |
|---|---|---|---|---|---|---|
| Zurück | Gibt den booleschen Wert basierend darauf zurück, ob das Element aktiv ist. | Daten Aus | Boolean | NA | NA |
SetText
Versucht, den Text für das Feld festzulegen.
| Parameter | Beschreibung | Datenport-Eintragstyp | Datentyp | Standardwert | Obligatorisch | Notizen |
|---|---|---|---|---|---|---|
| Text | Option zum Angeben des Texts, den die Methode im Feld festlegen möchte. | Daten In | Zeichenfolge | NA | Ja | Sie können diese Methode nicht auf geschützten Emulatorbildschirmen verwenden. |
Warten auf Erstellen
Wartet für die von Ihnen angegebene Dauer, während der Connector die Übereinstimmungsregel verwendet, um festzustellen, ob das Element vorhanden ist.
| Parameter | Beschreibung | Datenport-Eintragstyp | Datentyp | Standardwert | Obligatorisch | Notizen |
|---|---|---|---|---|---|---|
| ZeitüberschreitinSekunden | Option zur Angabe der Anzahl der Sekunden, für die die Methode wartet, während der Connector die Übereinstimmungsregel verwendet, um zu ermitteln, ob das Element vorhanden ist. | Daten In | Ganzzahl | 30 | Ja | |
| Zurück | Gibt den booleschen Wert zurück, abhängig davon, ob das Element gefunden wurde. | Daten Aus | Boolean | NA | NA |