Methoden des IBM PCOMM-Emulators

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

    • Mit den Methoden des IBM PCOMM-Emulators können Sie Aufgaben im IBM PCOMM-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 gesamten Text aus einem Feld zurück, nachdem er basierend auf der von Ihnen angegebenen Zeilen- und Spaltennummer identifiziert wurde. Die Zeile und die Spalte sind Teile des Felds. Die Abbildung zeigt, dass die Methode den Text AMD64 zurückgibt, obwohl Sie die Zeilen- und Spaltennummer des Buchstabens A angeben, da er Teil des Felds ist.

    Feld auf dem Bildschirm.

    Tabelle : 1. GetFieldText-Methodenparameter
    Parameter Beschreibung Eintragstyp des Datenports Datentyp Standardwert Obligatorisch? Notizen
    Zeile Nummer der Zeile im Terminal-Bildschirmfeld, auf deren Grundlage die Methode das Feld identifiziert. Daten ein Ganzzahl NA Ja
    Spalte Nummer der Spalte im Terminal-Bildschirmfeld, auf deren Grundlage die Methode das Feld identifiziert. Daten ein Ganzzahl NA Ja
    Zurück Gibt den vollständigen Text im Feld zurück. Datenausgabe Zeichenfolge. NA NA

    GetTextFromRect

    Gibt den Text aus einem imaginären rechteckigen Bereich auf dem Bildschirm zurück. Sie geben den rechteckigen Bereich an, indem Sie die Start- und Endzeilen- und -spaltennummern angeben. Die Abbildung zeigt einen rechteckigen Bereich auf dem Bildschirm und die Anfangs- und Endzeilen und -spalten.

    Rechteckiger Bereich auf einem Bildschirm.

    Tabelle : 2. Parameter der GetTextFromRect-Methode
    Parameter Beschreibung Eintragstyp des Datenports Datentyp Standardwert Obligatorisch? Notizen
    StartZeile Die Zeilennummer am Anfang des rechteckigen Bereichs. Daten ein Ganzzahl NA Ja
    Startspalte Die Spaltennummer am Anfang des rechteckigen Bereichs. Daten ein Ganzzahl NA Ja
    Endzeile Die Zeilennummer am Ende des rechteckigen Bereichs. Daten ein Ganzzahl NA Ja
    Endspalte Die Spaltennummer am Ende des rechteckigen Bereichs. Daten ein Ganzzahl NA Ja
    Zurück Gibt den gesamten Text aus dem imaginären rechteckigen Bereich 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 Option, damit die Methode den Emulatorbildschirm durch Abgleichen der untergeordneten Elemente finden kann. Daten ein Boolean Falsch Ja
    Warnung:
    Die Verwendung dieser Option kann die Methode verlangsamen.
    Zurück Gibt den booleschen Wert zurück, je nachdem, ob der Emulator-Bildschirm aktiv ist. Datenausgabe Boolean NA NA

    SearchText

    Gibt die Nummern der Zeile und Spalte zurück, die das erste Zeichen des von Ihnen angegebenen Texts enthalten. Wenn Sie beispielsweise den Zeichenfolgenemulator angeben, gibt die Methode die Zeilen- und Spaltennummern des Zeichens ezurück
    Hinweis:
    Wenn Sie Text angeben, der sich über mehrere Felder erstreckt, geben die Ports „ Zeile “ und „ Spalte “ 0 zurück, da die Methode nur Text aus einem einzelnen Feld unterstützt.
    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 Nummer der Zeile mit dem ersten Zeichen des von Ihnen angegebenen Texts. 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 Nummer der Spalte mit dem ersten Zeichen des von Ihnen angegebenen Texts. 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

    Simuliert Tastenanschläge an der Position des Mausgeräts auf dem Emulatorbildschirm, den Sie über die Tastatur eingeben. Sie können beispielsweise den Eingabetastenanschlag auf dem Bildschirm simulieren.

    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
    Tipp:
    Weitere Informationen zu den Tastenanschlägen für den IBM PCOMM-Emulator finden Sie unter https://www.ibm.com/docs/SSEQ5Y_6.0.0/com.ibm.pcomm.doc/books/pdf/emulator_referenceV60.pdf.

    SendKeysSecure

    Simuliert verschlüsselte Tastenanschläge an der Position des Mausgeräts auf dem Emulatorbildschirm.

    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 IBM PCOMM-Emulator finden Sie unter https://www.ibm.com/docs/SSEQ5Y_6.0.0/com.ibm.pcomm.doc/books/pdf/emulator_referenceV60.pdf.

    SetCursorPosition

    Legt das Mausgerät in der angegebenen Zeile und Spalte auf dem Emulatorbildschirm fest.
    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 die Maus auf dem Bildschirm festlegt. Daten ein Ganzzahl NA NA
    Spalte Option, um die Nummer der Spalte anzugeben, bei der die Methode die Maus auf dem Bildschirm festlegt. Daten ein Ganzzahl NA NA

    WartenAufErstellen

    Wartet, bis der Emulatorbildschirm für die von Ihnen angegebene Zeit aktiv wird.
    Tabelle : 8. Parameter der WaitForCreate-Methode
    Parameter Beschreibung Eintragstyp des Datenports Datentyp Standardwert Obligatorisch? Notizen
    ZeitüberschreitunginSekunden Anzahl der Sekunden, nach denen die Methode abläuft. Daten ein Ganzzahl 30 Ja
    AlleUntergeordneten abgleichen Option, damit die Methode warten kann, bis der Emulator-Bildschirm durch Abgleichen der Bildschirmelemente aktiv wird. Daten ein Boolean Falsch Ja
    Warnung:
    Die Verwendung dieser Option kann die Ausführung der Methode verzögern.
    Zurück Gibt den boolean Wert abhängig davon zurück, ob der Emulator-Bildschirm aktiv wurde. Datenausgabe Boolean NA NA

    Methoden auf Feldebene

    Um auf die Methoden auf Feldebene zuzugreifen, doppelklicken Sie auf das erfasste Feld oder die Tabelle. Die Methoden werden im Objekt-Explorer angezeigt.

    Methoden auf Feldebene.

    GetAlsTable

    Gibt den erfassten Text vom Terminal-Bildschirm in einem Tabellenformat zurück. Idealerweise sollten Sie diese Methode verwenden, wenn Sie Daten aus einem Bildschirm als Tabelle erfassen. Sie können diese Option jedoch auch für Daten verwenden, die Sie als Feld erfassen. Informationen zum Erfassen von Daten als Tabelle finden Sie unter IBM PCOMM-Emulator.
    Tabelle : 9. GetAsTable-Methodenparameter
    Parameter Beschreibung Eintragstyp des Datenports Datentyp Standardwert Obligatorisch? Notizen
    Zurück Gibt den erfassten Text vom Terminal-Bildschirm in einem Tabellenformat zurück. Datenausgabe Datentabelle NA NA Um die Tabelle anzuzeigen, klicken Sie mit der rechten Maustaste auf den Parameter, und wählen Sie Vorschaudatenaus.

    GetText

    Gibt den Text zurück, den Sie auf dem Emulator-Bildschirm erfasst haben. Idealerweise sollten Sie diese Methode verwenden, wenn Sie Daten aus einem Bildschirm als Feld erfassen.
    Hinweis:
    Wenn Sie diese Methode für eine Tabelle verwenden, die Sie erfasst haben, wird der Text im ersten Feld des imaginären rechteckigen Bereichs zurückgegeben.
    Tabelle : 10. GetText-Methodenparameter
    Parameter Beschreibung Eintragstyp des Datenports Datentyp Standardwert Obligatorisch? Notizen
    Zurück Gibt den Text aus dem erfassten Feld zurück. Datenausgabe Zeichenfolge NA NA Um die Tabelle anzuzeigen, klicken Sie mit der rechten Maustaste auf den Parameter, und wählen Sie Vorschaudatenaus.

    IstErstellt

    Überprüft, ob das Element aktiv ist.
    Tabelle : 11. IsCreated-Methodenparameter
    Parameter Beschreibung Eintragstyp des Datenports Datentyp Standardwert Obligatorisch? Notizen
    Zurück Gibt den booleschen Wert zurück, je nachdem, ob das Element aktiv ist. Datenausgabe Boolean NA NA

    Text festlegen

    Legt benutzerdefinierten Text im Feld oder in der Tabelle fest. Der benutzerdefinierte Text ersetzt ggf. vorhandenen Text.
    Tabelle : 12. SetText-Methodenparameter
    Parameter Beschreibung Eintragstyp des Datenports Datentyp Standardwert Obligatorisch? Notizen
    Text Text, den Sie im Feld oder in der Tabelle festlegen möchten. Daten ein Zeichenfolge NA Ja

    WartenAufErstellen

    Wartet, bis das Element für die von Ihnen angegebene Zeit aktiv wird.
    Tabelle : 13. Parameter der WaitForCreate-Methode
    Parameter Beschreibung Eintragstyp des Datenports Datentyp Standardwert Obligatorisch? Notizen
    ZeitüberschreitunginSekunden Anzahl der Sekunden, nach denen die Methode abläuft. Daten ein Ganzzahl 30 Ja
    Zurück Gibt den booleschen Wert zurück, je nachdem, ob das Element aktiv wird. Datenausgabe Boolean NA NA