Version 2.2

Transcription

Version 2.2

Version 2.2
Oktober 2000
Inhalt
Über dieses Handbuch
5
Symbole und Konventionen ...........................................................................5
Aufbau und Zielgruppe...................................................................................6
OnLine-Hilfe...................................................................................................6
So starten Sie die OnLine-Hilfe......................................................................6
Warenzeichen................................................................................................6
1. Einführung
7
1.1. Konvertierung mit dem HOBLink FaceLifter ............................................7
1.2. Neues Projekt .........................................................................................8
1.3. Projekt öffnen..........................................................................................8
1.4. Projekt speichern ....................................................................................8
1.5. Neue Form..............................................................................................8
1.6. Mehrere Forms .......................................................................................9
1.7. Projektinfo...............................................................................................9
1.8. Visual Basic ..........................................................................................10
1.9. Optionen ...............................................................................................10
1.9.1. Registerkarte "Allgemein"............................................................10
1.9.2. Registerkarte "Verbindung"..........................................................11
1.9.3. Registerkarte "Schriftarten" .........................................................12
1.9.4. Registerkarte "Formeinstellungen"...............................................12
1.9.5. Registerkarte "HOBSurf Eigenschaften" ......................................13
1.9.6. Registerkarte "Andere Eigenschaften" .........................................14
1.10. Info .....................................................................................................16
1.11. Hilfe ....................................................................................................16
1.12. Beenden..............................................................................................16
1.13. Wie Sie den HOBLink FaceLifter konfigurieren ...................................16
2. Erzeugen von GUI-Forms
17
2.1. Wie Sie Host-Anwendungen in graphische Benutzeroberflächen
konvertieren ..........................................................................................17
2.2. Wie Sie ein Projekt anderen Anwendern zugänglich machen .........18
3. Die HOB Controls in Visual Basic
19
3.1. HOB Controls in Visual Basic verwenden ..............................................20
4. Eigenschaften, Methoden und Ereignisse der HOB Controls
21
4.1. HOBSurf Control ...................................................................................21
4.1.1. Eigenschaften .............................................................................21
4.1.2. Methoden ....................................................................................23
4.1.3. Ereignisse ...................................................................................26
4.2. HOBButton Control ...............................................................................27
4.2.1. Eigenschaften .............................................................................27
4.2.2. Methoden ....................................................................................30
4.2.3. Ereignisse ...................................................................................30
4.3. HOBText Control...................................................................................32
4.3.1. Eigenschaften .............................................................................32
4.3.2. Methoden ....................................................................................34
4.3.3. Ereignisse ...................................................................................34
4.4. HOBList Control ....................................................................................35
4.4.1. Eigenschaften .............................................................................35
4.4.2. Methoden ....................................................................................36
4.4.3. Ereignisse ...................................................................................36
4.5. HOBCheckBtn Control ..........................................................................37
4.5.1. Eigenschaften .............................................................................37
4.5.2. Ereignisse ...................................................................................38
4.6. HOBRadio Control ................................................................................39
4.6.1. Eigenschaften .............................................................................39
4.6.2. Ereignisse ...................................................................................40
4.7. HOBCombo Control ..............................................................................41
4.7.1. Eigenschaften .............................................................................41
4.7.2. Methoden ....................................................................................41
4.7.3. Ereignisse ...................................................................................41
4.8. HOBOia Control ....................................................................................42
4.8.1. Eigenschaften .............................................................................42
4.8.2. Methoden ....................................................................................44
4.8.3. Ereignisse ...................................................................................44
4.9. HOBPS Control.....................................................................................45
4.9.1. Eigenschaften .............................................................................45
5. Konstanten
47
5.1. ActionType-Konstante...........................................................................47
5.2. AppearanceStyle-Konstante..................................................................47
5.3. BtnAppearanceStyle-Konstante.............................................................47
5.4. CheckValue-Konstante..........................................................................48
5.5. ComboStyle-Konstante .........................................................................48
5.6. CursorMode-Konstante .........................................................................48
5.7. FKeyType-Konstante.............................................................................49
5.8. JustifyStyle-Konstante...........................................................................49
5.9. KeyIndex-Konstante..............................................................................49
5.10. KeyLevel-Konstante ............................................................................50
5.11. LinkageTp-Konstante ..........................................................................50
5.12. PositionType-Konstante ......................................................................50
5.13. SbStyle-Konstante ..............................................................................51
6. Identifizieren, Hinzufügen und Löschen von HOB Controls
53
6.1. HOB Controls identifizieren...................................................................53
Wie Sie HOB Controls identifizieren und bearbeiten .............................53
6.2. HOB Controls hinzufügen......................................................................54
Wie Sie HOB Controls hinzufügen ........................................................54
6.3. HOB Controls löschen...........................................................................54
Wie Sie HOB Controls löschen .............................................................54
Verfügbare Tokens
55
Stichwortverzeichnis
57
Abbildungsverzeichnis
61
HOBLink FaceLifter____________________________________ Über dieses Handbuch
Über dieses Handbuch
Dieses Handbuch ist liefert umfassende Information und beschreibt die
Verfahren zur Installation, Konfiguration und den Umgang mit HOBLink
FaceLifter und den HOB Controls in Visual Basic.
Dieses Handbuch deckt keine Beschreibungen von Funktionen ab, die
nicht zum Lieferumfang der Software HOBLink FaceLifter gehören. Informationen zu produktfremden Funktionen finden Sie im Handbuch des
entsprechenden Produkts.
Wir gehen davon aus, daß der Benutzer dieses Handbuch mit den
grundlegenden Funktionen eines PCs vertraut ist und Basiskenntnisse
über die Betriebssysteme DOS und Windows besitzt.
Symbole und Konventionen
Im vorliegenden Handbuch und der OnLine-Hilfe werden bestimmte
Symbole und Schreibweisen verwendet, durch die ihre Bedeutung genau
definiert ist.
i
Dieses Piktogramm kennzeichnet Text mit besonderem informativem Charakter.
Dieses Piktogramm kennzeichnet Vorgänge, die weitreichende Folgen
haben können. Überlegen Sie bitte, ob die damit verbundenen Änderungen in Ihrem Sinn sind.
Wenn diese Symbolschaltfläche abgebildet ist, finden Sie in der
kontextbezogenen Hilfe weitere Hinweise zum Thema.
Wenn diese Symbolschaltfläche abgebildet ist, finden Sie in der
OnLine-Hilfe weitere Hinweise zum Thema.
Wie Sie die jeweilige Hilfefunktion starten, wird im Text beschrieben.
Verfahrensanweisungen sind mit dem links abgebildeten Piktogramm
gekennzeichnet, die einzelnen Verfahrensschritte sind fortlaufend numeriert,
z.B.
1.
2.
Schritt
Schritt…
• Tasten, oder Tastenkombinationen werden in eckigen Klammern dargestellt, z.B. [Leer].
• Referenzen auf HOBLink Programmbefehle und Dialogfelder, sind
fett gedruckt z.B. Wählen Sie den Befehl Öffnen….
• Optionen und Schaltflächen, die in einem Dialogfeld gewählt werden,
sind in Anführungszeichen dargestellt, z.B. "benutzerdefiniert".
• Querverweise auf Kapitelüberschriften unter Angabe von Seitenzahlen sind kursiv dargestellt und mit folgendem Piktogramm gekennzeichnet, z. B. F 1.1. Konvertierung mit dem HOBLink FaceLifter,
Seite 7.
© 2000 HOB electronic. Alle Rechte vorbehalten.
5
Über dieses Handbuch ____________________________________ HOBLink FaceLifter
• Von Ihnen einzugebender Text, Bildschirmanzeigen und Dateinamen
sind in der Schriftart Courier dargestellt. Halten Sie bei
Texteingaben die Groß- und Kleinschreibung ein.
• Die Begriffe "Host-Bildschirm", "Presentation Space" oder die
Abkürzung "PS" (stellvertretend für "Presentation Space" in den HostEigenschaften) sind gleichbedeutend und mit dem Begriff "HOBLink
Emulations-Bildschirm" identisch.
Aufbau und Zielgruppe
Um Ihnen den Umgang mit diesem Handbuch zu vereinfachen, ist dieses
Handbuch nach Aufgabenbereichen gegliedert. Die Zielgruppe dieses
Handbuchs sind Personen mit fundierten Programmierkenntnissen über
Microsoft Visual Basic.
OnLine-Hilfe
Die OnLine-Hilfe ist in ihrer Funktionsweise identisch mit der OnLineHilfe von Microsoft Windows. Sie enthält ausführliche Informationen über
die Konfiguration und den Umgang mit der Anwendung. Der Umfang der
OnLine-Hilfe deckt die Beschreibung aller Funktionen ab und gibt
Aufschluß in einzelnen Verfahrensschritten.
So starten Sie die OnLine-Hilfe
Die OnLine-Hilfe läßt sich an jeder Stelle im Programm mit einer oder
mehreren der aufgeführten Methoden aufrufen:
• Klicken auf
• [F1] drücken
Warenzeichen
Folgende Namen sind eingetragene Warenzeichen, urheberrechtlich
geschützt und Eigentum anderer Unternehmen:
• Microsoft Visual Basic ist Warenzeichen der Microsoft Corporation
6
HOBLink FaceLifter______________________________________________ Einführung
1
1. Einführung
Der HOBLink FaceLifter ist eine ergänzende Anwendung für die
Emulationen HOBLink 3270 und HOBLink 5250. Der HOBLink FaceLifter
ist ein vielseitiges Werkzeug, mit dem man die alphanumerische
Darstellung von Host-Anwendungen - die vorher mit HOBLink
aufgezeichnet werden - in eine graphische Benutzeroberfläche
(Graphical User Interface = GUI) konvertieren kann. Aber damit sind die
Möglichkeiten der konvertierten Host-Anwendung noch nicht ausgeschöpft.
Die von der Host-Anwendung erzeugte graphische Benutzeroberfläche
wird als Visual Basic-Form gespeichert. Eine oder mehrere Forms
können in einem Visual Basic-Projekt angelegt werden. Von diesen
Forms ausgehend können sind folgende Vorgänge möglich, z.B.
• Identifizieren, Hinzufügen und Löschen von HOB Controls
F
F
F
6.1. HOB Controls identifizieren, Seite 53
6.2. HOB Controls hinzufügen, Seite 54
6.3. HOB Controls löschen, Seite 54
Der HOBLink FaceLifter enthält zwei leistungsstarke Programmkomponenten:
• die Programmkomponente HOBLink FaceLifter (FACELIFT.EXE)
• die HOB Controls, die bei der Installation in Microsoft Visual Basic
implementiert werden.
1.1. Konvertierung mit dem HOBLink FaceLifter
Der HOBLink FaceLifter portiert Host-Anwendungen in das anwenderorientierte GUI-Format.
Abbildung 1: HOBLink FaceLifter
Wie Sie in der Abbildung sehen, stellt sich der HOBLink FaceLifter als
Symbolleiste dar. Die verfügbaren Schaltflächen werden in ihrer
Anordnung von links nach rechts nachfolgend beschrieben:
7
Einführung______________________________________________ HOBLink FaceLifter
1.2. Neues Projekt
Abbildung 2: Neues Projekt
Legt ein neues Visual Basic-Projekt (*.VBP) an. Eine Projektdatei kann
eine oder mehrere Forms beinhalten, die mit dem HOBLink FaceLifter
erstellt wurden.
So können alle gewünschten Forms für eine Anwendung in einem Zug
erstellt werden (d.h. anstatt für jeden erzeugten Host-Bildschirm ein
neues Projekt zu erzeugen). Das generierte Projekt kann in Visual Basic
bearbeitet werden.
1.3. Projekt öffnen
Abbildung 3: Projekt öffnen
Öffnet ein vorhandenes Visual Basic-Projekt, das mit dem HOBLink
FaceLifter vorher erstellt wurde und ermöglicht das Hinzufügen weiterer
Forms.
1.4. Projekt speichern
Abbildung 4: Projekt speichern
Speichert das aktuelle Visual Basic-Projekt.
Beim Speichern des aktuellen Projekts erscheint die Abfrage, ob das
Projekt mit Visual Basic geöffnet werden soll. Dies erleichtert die Interaktion zwischen HOBLink FaceLifter und Visual Basic.
i
Beim Speichern eines Projekts wird automatisch eine COMMFORM.FRM
angelegt.
Jeder Bildschirm, der im FormTable nicht vorhanden ist, wird standardmäßig im
Dialogfeld "Unkonvertierter Bildschirm" angezeigt und wird in der
UNLIFTED.FRM hinterlegt.
1.5. Neue Form
Abbildung 5: Neue Form
Konvertiert einen Host-Bildschirm in eine Visual Basic-Form.
i
8
Wenn ein neues Projekt erstellt oder ein vorhandenes geöffnet wurde, wird diese
Schaltfläche wählbar.
So können alle gewünschten Forms für eine Anwendung erzeugt und
dem Projekt hinzugefügt werden (d.h. anstatt für jeden erzeugten HostBildschirm ein neues Projekt zu erzeugen). Das generierte Projekt kann
in Visual Basic bearbeitet werden.
i
Um mehrere Forms in einem Zug zu erstellen, wählen Sie die Schalfläche
"Mehrere Forms".
1.6. Mehrere Forms
Abbildung 6: Mehrere Forms
Ermöglicht das Erzeugen mehrerer Forms auf einmal. Dazu muß eine
Bildschirmdatei *.HSS angegeben werden, die die entsprechenden HostBildschirme enthält. Die Bildschirmdatei enthält eine Übersicht aller
verfügbaren Host-Bildschirme, die einzeln gewählt werden können.
Abbildung 7: Dialogfeld Mehrere Forms
1.7. Projektinfo
Abbildung 8: Projektinfo
Das Dialogfeld Projektinformation zeigt eine Liste der Forms dieses
Projekts, die mit dem HOBLink FaceLifter aus Host-Anwendungen
erstellt wurden.
Abbildung 9: Dialogfeld Projektinfo
9
1.8. Visual Basic
Abbildung 10: Visual Basic
Startet die Microsoft-Anwendung Visual Basic, um das Projekt zu öffnen.
Das erleichtert das Bearbeiten und Modifizieren einer vorher mit dem
HOBLink FaceLifter erstellten Form.
1.9. Optionen
Abbildung 11: Optionen
Dieses Dialogfeld enthält alle erforderlichen Optionen zum Erstellen von
GUI-Forms. Die verfügbaren Optionen sind erforderlich für die
Verbindung, die HOBSurf Control und einige allgemeine Einstellungen.
Folgende Registerkarten werden entsprechend Ihrer Anordnung im
Dialogfeld von links nach rechts, mit der Vordergrundebene beginnend
beschrieben.
1.9.1. Registerkarte "Allgemein"
Abbildung 12: Optionen - Registerkarte "Allgemein"
Visual Basic
Stellt die verwendete Version von Visual Basic ein.
Kleine Symbole
Die HOBLink FaceLifter-Symbolleiste wird mit kleinen Symbolen dargestellt.
Beschriftete Symbole
Die Symbole erscheinen mit treffendem Funktionsbegriff untertitelt.
10
In Schaltflächen konvertieren
Alle im Anwendungs-Bildschirm gefundenen PF-Tasten werden in
HOBButton Controls konvertiert.
Immer im Vordergrund
Der HOBLink FaceLifter bleibt immer im Vordergrund stehen,
gleichgültig ob andere Anwendungen aktiv sind oder nicht.
Geschützte Leerfelder entfernen
Entfernt geschützte Leerfelder im Bildschirm.
Controls als Arrays erzeugen
HOB Controls werden als Indexobjekte angelegt. Die Indizierung macht
es einfach für Sie, ausgewählten HOB Controls spezifische
Eigenschaften in einem einzigen Arbeitsgang global zuzuweisen.
1.9.2. Registerkarte "Verbindung"
Abbildung 13: Optionen - Registerkarte "Verbindung"
Emulation
Die Emulation ist eine Zeichenfolge, die den Server-Namen der Session
enthält, die für die Verbindung mit der Emulation verwendet wird.
Wählen Sie den entsprechenden HOBLink-Emulationstyp, mit dem Sie
eine Verbindung aufbauen möchten.
Session
Die Session ist eine Zeichenfolge, die das Topic der Session enthält, die
für die Verbindung mit der betreffenden Session der Emulation
verwendet wird. Abhängig von der verwendeten Session sind z.B.
folgende Einträge möglich: SESSIONA, SESSIONB etc.
Host-Bildschirmdatei / Host-Pfaddatei
Diese Dateien enthalten die Host-Bildschirme, die in Visual Basic Forms
konvertiert werden sollen. Beide Dateien werden vom HOBLink
FaceLifter in das Projekt-Verzeichnis kopiert. Sobald die Visual BasicAnwendung gestartet wird, verwendet HOBLink die hier angegebenen
Dateien.
11
Verwenden Sie die Schaltfläche "...", um nach der entsprechenden Datei
im Format *.HSS / *.HSP zu suchen.
1.9.3. Registerkarte "Schriftarten"
Abbildung 14: Optionen - Registerkarte "Schriftarten"
Modell
Wählt das entsprechende Modell im Listenfeld.
Schriftart
Zeigt die aktuell gewählte Schriftart an, die mit der Schaltfläche
"Schriftart..." geändert werden kann.
Schriftgröße
Zeigt die aktuell gewählte Schriftgröße an, die mit der Schaltfläche
"Schriftart..." geändert werden kann.
1.9.4. Registerkarte "Formeinstellungen"
Abbildung 15: Optionen - Registerkarte "Formeinstellungen"
MDI-Projekt erstellen
Wenn aktiviert, wird ein MDI-Projekt einschließlich Menü erzeugt. Der
Vorteil dieser Einstellung besteht darin, dass der Anwender nur eine
Programmoberfläche sieht. Die CommForm-Funktion wird von der MDIForm übernommen.
12
(Comm)Form oben
Bestimmt die Position des oberen Randes der (Comm)Form.
(Comm)Formhöhe
Bestimmt die Höhe der (Comm)Form in Pixeln.
(Comm)Form links
Bestimmt die Position des linken Rands der (Comm)Form.
(Comm)Formbreite
Bestimmt die (Comm)Formbreite in Pixeln.
Control-Größe der gewählten Schriftart anpassen
Stellt sicher, dass die Control-Größe entsprechend der gewählten
Schriftart dynamisch angepasst wird, sobald eine Änderung erfolgt ist.
Control-Größe der gewählten Schriftart anpassen
Die Größe der konvertierten Controls richtet sich nach der eingestellten
Schriftart. Bleibt dieses Kontrollkästchen unmarkiert, richtet sich die
Größe nach der Formgröße.
1.9.5. Registerkarte "HOBSurf Eigenschaften"
Abbildung 16: Optionen - Registerkarte "HOBSurf Eigenschaften"
Host Quiet Time
Gibt für alle Bildschirme, die mit dem HOBLink FaceLifter konvertiert
werden, den standardmäßigen Zeitintervall an, der abgewartet wird, bis
weitere Host-Aktionen registriert werden.
Diese Eigenschaft verhindert folgende Negativeffekte:
• Bestimmte Host-Anwendungen senden Bilder an die Emulation und
geben dabei die Tastatur frei, obwohl die Anwendung noch einige
Millisekunden mehr beansprucht bis weitere Tastatureingaben angenommen werden können.
• Andere Host-Anwendungen senden ein oder mehrere Zwischenbilder
bevor das endgültige Bild erscheint. Ohne Host Quiet Time sind diese
13
Bilder für den Anwender sichtbar und verursachen Flackern auf dem
Bildschirm.
Max. Time to wait
Die MaximumTimeToWait ist die vom Anwender bestimmte Zeitdauer,
um zu prüfen, ob der Host bereit ist.
Emulation starten
Die Emulation wird automatisch gestartet, sobald das mit Visual Basic
erzeugte Projekt gestartet wurde.
Emulation schließen
Die Emulation wird automatisch beendet, sobald das Visual Basic
Projektprogramm beendet wurde.
Standard (Schaltfläche)
Setzt die Optionen auf die Standardeinstellung zurück.
1.9.6. Registerkarte "Andere Eigenschaften"
Abbildung 17: Optionen - Registerkarte "Andere Eigenschaften"
Select Text On Focus (HOBText Control)
Gibt an, ob der Text markiert erscheint oder nicht, sobald dieses Feld
gewählt wird.
+ Eigenschaft "4.3.1.17. SelectTextOnFocus", Seite 33
Auto Skip (HOBText Control)
Gibt an, ob der Cursor geschützte Felder überspringt und im nächsten
ungeschützten Feld positioniert wird.
+ Eigenschaft "4.3.1.2. AutoSkip", Seite 32
Hide When Not Present (HOBButton Control)
Gibt an, ob die HOB Control verborgen oder "disabled" wird, falls der
entsprechende HostText (HOB Controls-Eigenschaften) gefunden wird
oder nicht.
14
+ Eigenschaft "4.2.1.11. HideWhenNotPresent", Seite 28
Want Host Keys
Gibt an, ob die Control Host-Tasten an die Emulation sendet.
+ Eigenschaft "4.2.1.23. WantHostKeys", Seite 29
Disable AID
Gibt an, ob die Control AID-Tasten an den Bildschirm sendet.
+ Eigenschaft "4.2.1.5. DisableAID", Seite 27
Use Host Colors
Gibt an, dass alle HOB Controls standardmäßig Host-Farben und nicht
Visual Basic-Farben verwenden.
+ Eigenschaft "4.2.1.22. UseHostColors", Seite 29
Standard (Schaltfläche)
Setzt die Optionen auf die Standardeinstellung zurück.
15
1.10. Info
Abbildung 18: Info
Zeigt Copyright-Hinweise, Serien- und Versionsnummer an.
1.11. Hilfe
Abbildung 19: Hilfe
Zeigt die Hilfethemen an, aus denen Sie auswählen können.
1.12. Beenden
Abbildung 20: Beenden
Beendet den HOBLink FaceLIfter.
1.13. Wie Sie den HOBLink FaceLifter
konfigurieren
1.
2.
3.
16
HOBLink FaceLifter starten.
"Optionen" klicken.
Registerkarte Verbindung wählen und die erforderlichen Angaben
eintragen.
HOBLink FaceLifter__________________________________ Erzeugen von GUI-Forms
2
2. Erzeugen von GUI-Forms
Um ihre Host-Anwendung in eine graphische Benutzeroberfläche zu konvertieren, führen Sie folgende Schritte aus:
2.1. Wie Sie Host-Anwendungen in graphische
Benutzeroberflächen konvertieren
1.
Microsoft Visual Basic 4.0 oder höher muß auf Ihrem System
installiert sein.
2.
HOBLink 3270 oder 5250 starten.
Host-Bildschirme in der HOBLink-Emulation aufzeichnen
3.
4.
"Host-Bildschirme aufzeichnen" im Menü Makro wählen.
5.
(Optional):
Den für die Bildschirmerkennung relevanten Textbereich wählen
und das Kontrollkästchen "nur Texterkennung" markieren. Dieser
Text wird zur Identifizierung des gewünschten Host-Bildschirms
herangezogen.
6.
Nächsten Bildschirm aufzeichnen oder Aufzeichnen mit der "X"Schaltfläche beenden.
Tragen Sie den Namen des aufzuzeichnenden Host-Bildschirms
ein.
Ohne aufgezeichneten Bildschirm ist die HOB Surf Control nicht in
der Lage, den Host-Bildschirm zu erkennen und damit die entsprechende Visual Basic Form aufzurufen.
7.
HOBLink FaceLifter starten. Beim ersten Start müssen Sie die
Anwendung zunächst konfigurieren (1.13. Wie Sie den HOBLink
FaceLifter konfigurieren, Seite 16).
8.
9.
"Neues Projekt" in der Symbolleiste klicken.
10.
"Neue Form" in der Symbolleiste klicken. Der Name des momentan
in der HOBLink-Emulation geladenen Host-Bildschirms erscheint
als Standardname für die Form (*.FRM). Die alphanumerische
Darstellung der Host-Anwendung wird automatisch in eine Visual
Basic Form konvertiert.
11.
Schritte 9 und 10 für weitere zu konvertierende Host-Anwendungen
ausführen. Wahlweise können auch mehrere Host-Bildschirme in
einem Zug mit "Mehrere Forms" konvertiert werden.
12.
"Projekt speichern" klicken, um alle Formen anzulegen und als
Visual Basic-Projekt zu speichern. Geben Sie einen Namen an.
In der HOBLink-Emulation den zu konvertierenden Bildschirm
anzeigen.
17
Erzeugen von GUI-Forms__________________________________ HOBLink FaceLifter
Alle Formen und Projektdateien müssen im gleichen Verzeichnis
sein, sonst tritt eine Fehlermeldung auf.
EXE-Datei in Visual Basic erstellen
13.
Gewünschtes "Projekt" wählen und eine EXE-Datei gemäß der
Dokumentation von Visual Basic erzeugen.
Die aus der ursprünglichen Host-Anwendung erzeugte EXE-Datei ist
sofort ausführbar und steht dem Anwender unmittelbar zur Verfügung.
Vergewissern Sie sich, daß alle projektbezogenen Host-Bildschirme
verfügbar sind. Weitere Informationen dazu unter Schritt 3 bis 5 des
folgenden Themas.
2.2. Wie Sie ein Projekt anderen Anwendern zugänglich
machen
1.
2.
"Installations-Assistent" im Visual Basic-Ordner starten.
3.
Vergewissern Sie sich, daß unter der Führung des InstallationsAssistenten alle Host-Bildschirm-Surfer-Dateien (*.HSS und *.HSP)
(Schaltfläche "Optionen" Registerkarte "Verbindung") in das Installationsprojekt eingebunden werden. Diese Dateien kopiert der
HOBLink FaceLifter beim Speichern des Visual Basic-Projekts in
das Projektverzeichnis. Beide Dateien sind erforderlich, damit
HOBLink die Host-Bildschirme dem Visual Basic zur Verfügung
stellt.
Der Installations-Assistent erzeugt eine EXE-Datei und stellt sicher,
daß alle erforderlichen Bibliotheken und Dateien auf einem
anderen PC installiert werden.
Wenn Sie im Visual Basic-Projekt Makros verwenden (z.B. die
HOBSurf-Methode SendMacro), vergewissern Sie sich, alle Makrodateien in der Visual Basic Installation einzubinden.
4.
Der Installations-Assistent erzeugt jetzt eine SETUP.EXE-Datei für
das Projekt.
5.
Installation auf dem Anwender-PC
a. Installieren Sie auf dem Anwender-PC den HOBLink FaceLifter
und wählen Sie im Installationsprogramm die Option "Laufzeit
VB Controls".
b. Installieren Sie die erzeugte Anwendung auf dem Anwender-PC.
Die erforderlichen Surfer-Dateien (*.HSP und *.HSS) müssen von
der Anwendung korrekt geladen werden, um sie HOBLink zur
Verfügung zu stellen.
Prüfen Sie eventuell die Eigenschaften "HostScreensFile" und
"HostPathsFile" der HOBSurf Control.
18
HOBLink FaceLifter____________________________ Die HOB Controls in Visual Basic
3
3. Die HOB Controls in Visual Basic
Mit dem Installationsprogramm für den HOBLink FaceLifter werden
zusätzlich HOB Controls installiert, die in Microsoft Visual Basic als
*.OCX-Komponente eingebunden werden. Diese HOB Controls ermöglichen das Bearbeiten von Forms, die vorher mit dem HOBLink
FaceLifter von Host-Anwendungen erzeugt wurden.
Die HOB Controls stellen die Verbindung der Visual Basic-Form mit den
Host-Bildschirmen her. Der HOBLink FaceLifter verwendet die HOB
Controls, um diese Host-Bildschirme zu konvertieren. Alle HOB Controls
sind den standardmäßigen Visual Basic Controls ähnlich, besitzen aber
zusätzlich Host-Eigenschaften, z.B. PSCaptionStart, PSCaptionLength,
wobei "PS" für den Begriff Presentation Space steht.
Die HOBSurf Control ist dabei die wichtigste HOB Control. Man kann die
HOBSurf Control auch als die "zentrale" Control bezeichnen, denn sie
stellt die Verbindung zu HOBLink her. Jede Session erfordert genau eine
HOBSuf Control, die angibt, mit welcher Session sie kommuniziert. Wie
bei den anderen Controls muß die Session angegeben werden, der sie
zugeordnet sind,
Abbildung 21: Verbindung zwischen HOBLink und Visual Basic
Folgende HOB Controls sind in Visual Basic-Forms verfügbar:
HOB Control
Schaltfläche
HOBSurf Control
HOBButton Control
HOBText Control
HOBList Control
HOBChkBtn Control
HOBRadio Control
HOBOia Control
HOBCombo Control
HOBPS Control
19
Die HOB Controls in Visual Basic____________________________ HOBLink FaceLifter
Auf diese Art und Weise können Sie in der Visual Basic-Form sogar
Abläufe zuordnen, die von der Host-Anwendung nicht unterstützt werden.
HOBLink ist das Medium, das die in einer Form vorhandenen HOB
Controls empfängt und verarbeitet und deren Daten dem Host zur Verarbeitung übergibt. Damit sind Sie nicht länger den Einschränkungen Ihrer
Host-Anwendungen unterworfen.
3.1. HOB Controls in Visual Basic verwenden
Um die HOB Controls in Visual Basic zu verwenden, müssen Sie im
Menü Extras den Befehl Zusatzsteuerelemente... wählen und im
Dialogfeld den Eintrag HOBLink 3270 OLE Controls module
markieren.
Bei Visual Basic 5.0 klicken Sie den Befehl Komponenten im Menü
Projekt.
20
HOBLink FaceLifter_______ Eigenschaften, Methoden und Ereignisse der HOB Controls
4
4. Eigenschaften, Methoden und Ereignisse der
HOB Controls
Diese Kapitel beschreibt in Kürze die Eigenschaften, Methoden und
Ereignisse der HOB Controls. Die HOB Controls werden in derselben
Reihenfolge beschrieben, in der sie in der Werkzeugsammlung von
Visual Basic erscheinen.
4.1. HOBSurf Control
Die HOBSurf Control ist die Kommunikationskomponente zwischen der
HOBLink 3270- oder HOBLink 5250-Session und allen anderen Controls.
Das bedeutet, daß bei Kommunikation Ihrer Visual Basic-Anwendung mit
mehr als einer Host-Session, für jede Host-Session eine eigene HOBSurf
Control erforderlich ist. Die Datei FACELIFT.EXE (HOBLink FaceLifterAnwendung) bindet diese Information standardmäßig in die
COMMFORM.FRM ein, sobald von einer Host-Anwendung eine Visual BasicForm erstellt und als Projekt gespeichert wird. In jedem mit dem
HOBLink FaceLifter erstellten Projekt muß mindestens eine HOBSurf
Control vorhanden sein.
Die COMMFORM.FRM enthält die erforderliche HOBSurf Control, die die
Verbindung zwischen dem Projekt und HOBLink herstellt. HOBLink muß
im Hintergrund laufen, denn HOBLink empfängt die Daten der HOB
Controls einer Visual Basic-Form, verarbeitet sie und leitet sie an den
Host weiter.
Verändern Sie die Standardeinstellungen der HOBSurf Control
nicht. Wenn das Projekt mit dem HOBLink FaceLifter gespeichert
wird, werden alle Änderungen wieder überschrieben.
4.1.1. Eigenschaften
4.1.1.1. AutomaticCloseEmulation
Dieser Ausdruck gibt an, ob die Emulation automatisch beendet wird,
wenn die Control entladen wird.
4.1.1.2. AutomaticHideEmulation
Dieser Ausdruck gibt an, ob die Emulation automatisch verborgen wird,
wenn die Control einen bekannten Bildschirm identifiziert.
4.1.1.3. AutomaticStartEmulation
Dieser Ausdruck gibt an, ob die Emulation automatisch gestartet wird,
wenn die Control geladen wird.
Zum Starten der Emulation kann mit Hilfe der Eigenschaft HlkFile
(Seite 22) ein HOBLink-Profil (Konfigurationsdatei) angegeben werden.
21
Eigenschaften, Methoden und Ereignisse der HOB Controls ______ HOBLink FaceLifter
4.1.1.4. DefaultHostQuietTime
Gibt den standardmäßigen Zeitintervall für die Eigenschaft UnliftedForm
(Seite 23) an, der abgewartet wird, bis weitere Host-Aktionen registriert
werden.
Diese Eigenschaft verhindert folgende Negativeffekte:
• Bestimmte Host-Anwendungen senden Bilder an die Emulation und
geben dabei die Tastatur frei, obwohl die Anwendung noch einige
Millisekunden mehr beansprucht bis weitere Tastatureingaben angenommen werden können.
• Andere Host-Anwendungen senden ein oder mehrere Zwischenbilder
bevor das endgültige Bild erscheint. Ohne Host Quiet Time sind diese
Bilder für den Anwender sichtbar und verursachen Flackern auf dem
Bildschirm.
4.1.1.5. DisableKeyBuffer
Dieser Ausdruck gibt an, ob der Tastaturpuffer der Emulation verwendet
wird oder nicht.
Der Tastaturpuffer speichert Tasteneingaben des Benutzers, wenn der
Host-Bildschirm beschäftigt ist und verarbeitet sie sobald er wieder bereit
ist.
4.1.1.6. Emulation
Emulation ist eine Zeichenfolge, die den Server-Namen der Session
enthält, die verwendet wird, um die Verbindung mit der Emulation
aufzubauen. Tragen Sie HOBLINK (wenn Sie HOBLink 3270 verwenden)
oder HOBLINK5250 (wenn Sie HOBLink 5250 verwenden).
4.1.1.7. FormTable
Diese Eigenschaft sollte nur in der Registerkarte "Form Table" geändert
werden.
Ein Listenfeld mit den Bildschirmnamen (sie entsprechen den Surfer
Host-Bildschirmnamen) und den Visual Basic Formnamen erscheint.
Verwenden Sie für die entsprechenden Vorgänge die Schaltflächen
"Neu...", "Bearbeiten..." und "Entfernen".
Jeder Bildschirm, der im FormTable nicht vorhanden ist, wird standardmäßig unter "Unlifted Form" angezeigt. Dieser Eintrag läßt sich mit der
Eigenschaft UnliftedForm (Seite 23) bestimmen.
4.1.1.8. HlkFile
Gibt entweder ein HOBLink 3270-Profil (*.HLK)oder HOBLink 5250-Profil
an (*.HLF). Diese wird verwendet, wenn die Eigenschaft
AutomaticStartEmulation (Seite 21) eingestellt ist und ist zur Laufzeit
schreibgeschützt.
4.1.1.9. HostPathsFile
Diese Datei enthält zusammen mit der Eigenschaft "HostScreensFile"
die Host-Bildschirme, die in Visual Basic Forms konvertiert werden
sollen. Beide Dateien werden vom HOBLink FaceLifter in das ProjektVerzeichnis kopiert. Sobald die Visual Basic-Anwendung gestartet wird,
22
verwendet die HOBLink-Emulation die hier angegebenen Dateien. Zur
Laufzeit schreibgeschützt.
4.1.1.10. HostScreensFile
Diese Datei enthält zusammen mit der Eigenschaft "HostPathsFile" die
Host-Bildschirme, die in Visual Basic Forms konvertiert werden sollen.
Beide Dateien werden vom HOBLink FaceLifter in das ProjektVerzeichnis kopiert. Sobald die Visual Basic-Anwendung gestartet wird,
verwendet die HOBLink-Emulation die hier angegebenen Dateien. Zur
Laufzeit schreibgeschützt.
4.1.1.11. MaximumTimeToWait
Diese Eigenschaft kooperiert mit WaitHostQuiet (Seite 26). Die
MaximumTimeToWait ist die vom Anwender bestimmte Zeitdauer, um
zu prüfen, ob der Host bereit ist. Wenn der Host während der ersten
WaitHostQuiet beschäftigt ist, prüft er die Bereitschaft erneut mit
WaitHostQuiet bis dieser Zustand des Hosts die angegebene
MaximumTimeToWait überschreitet.
4.1.1.12. RemoveTrailingChars
Diese Eigenschaft entfernt die definierten Feldzeichen (z.B. Punkte und
Unterstriche) aus den Eingabefeldern im Presentation Space.
4.1.1.13. Session
Session ist eine Zeichenfolge, die das Topic der Session enthält, die
verwendet wird, um die Verbindung zu der entsprechenden Session der
Emulation aufzubauen. Abhängig von der verwendeten Session kann der
Eintrag z.B. SESSIONA, SESSIONB etc. sein.
Wenn hier keine Session eingetragen wird, muss diese mit der Methode
Connect angegeben werden, die die durch die Eigenschaften Emulation
und Session definiert ist.
4.1.1.14. UnliftedForm
Gibt an, welche Form angezeigt wird, wenn in der Emulation ein Bildschirm nicht erkannt wurde, oder wenn der dort erkannte Host-Bildschirm
nicht in der FormTable (Seite 22) vorhanden ist.
4.1.2. Methoden
4.1.2.1. Connect
Diese Methode ermöglicht es die aktuelle Verbindung zu trennen und
über dieselbe HOBSurf Control eine Verbindung zu einer anderen
HOBLink-Session aufzubauen. Sie müssen dazu mit der Eigenschaft
Emulation die gewünschte HOBLink-Emulation und mit der Eigenschaft
Session die gewünschte Session angeben.
4.1.2.2. GetCurrentScreenName
Diese Methode wird verwendet, um den aktuellen Host-Bildschirmnamen
in der Emulation abzufragen.
23
4.1.2.3. GetCursor
Diese Methode gibt die aktuelle Cursor-Position im Presentation Space
zurück.
4.1.2.4. GetText
Diese Methode gibt den aktuellen Text (sichbare und unsichtbare
Zeichen) im Presentation Space zurück.
4.1.2.5. GetTextEx
Diese Methode gibt den aktuellen Text (wahlweise alle sichtbaren /
unsichtbaren oder nur sichtbare Zeichen) im Presentation Space zurück.
4.1.2.6. HideEmulation
Diese Methode wird verwendet, um die Emulation zu verbergen.
4.1.2.7. Initialize
Diese Methode ist erforderlich für HOB Controls, die in
Entwicklungssystemen verwendet werden, die die Eigenschaft
AmbientName nicht unterstützen (entspricht der Eigenschaft Name von
Visual Basic). Visual C++ Appstudio, z.B. verwendet für die Controls
nicht die Eigenschaft Name, sondern eine ID (IDC_...). Da die HOB
Controls mit der HOBSurf Control über die Eigenschaft SurfControl
kommunizieren, besitzt die HOBSurf Control keine Eigenschaft Name,
mit der Sie sich selbst identifizieren kann. Aus diesem Grund ist eine
Methode erforderlich, um den üblichen Kommunikationsprozeß
anzustoßen, nachdem diese Methode aufgerufen wurde. Dies geschieht
durch Aufrufen dieser Methode im WM_INITDIALOG mit
Initialize("HOBSurf1");
Sobald dies geschieht, kommunizieren die HOB Controls mit der
HOBLink-Emulatioin wie gewohnt.
i
Diese Methode hat keinerlei Auswirkung in Visual Basic, da die Eigenschaft
Name bereits der HOBSurf Control zugeordnet ist.
4.1.2.8. ClearKeyLevel
Diese Methode löscht alle von der Standardbelegung der Tastatur
abweichenden Anpassungen auf der (den) Ebene(n), die mit der
Konstante KeyLevel angegeben wird (werden).
4.1.2.9. SendKey
Diese Methode wird verwendet, um der Emulation eine Funktion
und/oder Text, wie beispielsweise PF1, PF2, Enter zu übergeben.
F
Verfügbare Tokens, Seite 55
4.1.2.10. SendMacro
Diese Methode wird verwendet, um ein Makro in der Emulation zu
starten. Nur der Name wird als Parameter übergeben, z.B. um das Makro
24
LOGON.MAC zu starten, sollte nur LOGON als Parameter übergeben
werden.
4.1.2.11. SendText
Diese Methode wird verwendet, um eine Zeichenfolge mit angegebener
Länge an die angegebene Position im Presentation Space zu senden.
4.1.2.12. SetCursor
Diese Methode wird verwendet, um den Cursor im Presentation Space
zu positionieren.
4.1.2.13. SetKeyMappingLevel
Diese Methode weist einer oder mehreren Tasten, die mit der Konstante
KeyIndex bestimmt wird (werden), auf der (den) Belegungsebene(n), die
mit der Konstante KeyLevel angegeben wird (werden), eine neue
Funktion zu. Die neue Funktion der Taste(n) weisen Sie über Tokens zu.
F
4.1.2.14. ShowEmulation
Diese Methode wird verwendet, um die Emulation anzuzeigen, wenn sie
verborgen ist.
4.1.2.15. StartScreenUpdate
Diese Methode wird verwendet, um die Form automatisch zu aktualisieren, sobald sich der Inhalt des Host-Bildschirms ändert.
StartScreenUpdate beginnt wieder das Ereignis OnScreenChange
(Seite 26) zu empfangen und ist als Standard eingestellt.
Sinnvoll ist diese Methode, um nur den endgültigen Bildschirm zu
aktualisieren, wenn eine Reihe von Bildschirmen geschickt wird.
4.1.2.16. StopScreenUpdate
Diese Methode wird verwendet, um die automatische Aktualisierung der
Form zu unterdrücken, sobald sich der Inhalt des Host-Bildschirms
geändert hat. Wird diese Methode aufgerufen, wird das Ereignis
OnScreenChange (Seite 26) nicht ausgelöst.
4.1.2.17. SurfToScreen
Surft unter Angabe des Host-Bildschirmnamens von einem Host-Bildschirm zum angegebenen Host-Bildschirm.
4.1.2.18. Update
Nur für HOBSurf Control
Aktualisiert eine Visual Basic-Form.
Nur für HOBOia Control
Aktualisiert die Anzeigebereiche dieser Control.
25
4.1.2.19. WaitHostQuiet
Diese Methode wird verwendet, um die Anzeige eines neuen Bildschirms
abzuwarten.
4.1.3. Ereignisse
4.1.3.1. OnError
Dieses Ereignis liegt vor, wenn nach einer bestimmten Transaktion ein
Fehler auftritt.
i
Standardmäßig wird vom HOBLink FaceLifter eine Routine eingefügt, die den
aufgetretenen Fehler in einem Dialogfeld anzeigt.
+ Weitere Hinweise in der OnLIne-Hilfe
Klicken Sie in der Registerkarte Index auf das Hilfethema "OnError".
4.1.3.2. OnScreenChange
Dieses Ereignis liegt vor, wenn im Presentation Space ein neuer Bildschirm angezeigt wird. Dieses Ereignis wird verwendet, um den
Anwender zu informieren, wenn sich der Bildschirm ändert. Der HOBLink
FaceLifter generiert den Visual Basic-Code, der die entsprechende
Visual Basic-Form lädt.
Der vom HOBLink FaceLifter generierte Code sollte nicht geändert
werden, da der Inhalt bei jedem Speichervorgang des Projekts
überschrieben wird.
4.1.3.3. OnScreenUpdated
Dieses Ereignis liegt vor, wenn alle Controls in der Form "FormName"
aktualisiert werden. Dies geschieht normalerweise unmittelbar nachdem
das Ereignis OnScreenChange ausgelöst wurde. Dieses Ereignis wird
verwendet, um den Anwender zu informieren, daß die Felder aktualisiert
worden sind, nachdem sich der Presentation Space geändert hat.
26
4.2. HOBButton Control
Die HOBButton Control generiert eine Schaltfläche in der Form.
4.2.1.1. Appearance
Die Darstellungsart der Control zum Entwicklungszeitpunkt wird zurückgegeben oder eingestellt. Zur Laufzeit schreibgeschützt.
4.2.1.2. AutoEnter
Gibt an, ob Zeichen oder Zeichenfolgen, die mit der Konstante hlKey die
Eigenschaft ButtonType bestimmen, an den Host gesendet werden.
4.2.1.3. ButtonType
Gibt an, ob die Schaltfläche eine Funktion (Funktionstaste), eine Taste
(eine Zeichenfolge an den Host) sendet oder ein Makro ausführt, wenn
sie gedrückt wird. Standardmäßig wird diese Eigenschaft mit dem Typ
Function (Seite 28) eingestellt.
4.2.1.4. Caption
Der angezeigte Text wird in oder neben eine Control gesetzt oder
zurückgegeben. Der Text wird nur angezeigt, wenn die Eigenschaft
StaticCaption (Seite 29) auf True eingestellt ist.
4.2.1.5. DisableAID
Dieser Ausdruck gibt an, ob die Control AID-Tasten an den Bildschirm
sendet.
4.2.1.6. Enabled
Gibt einen Wert zurück oder legt einen Wert fest, der bestimmt, ob die
Control auf vom Anwender ausgelöste Ereignisse reagieren kann.
4.2.1.7. FKeysType
Determines the HOBLink emulation, whose function keys are to be
executed by the HOB Control.
4.2.1.8. Font
Der Font einer Control wird zurückgegeben oder eingestellt.
i
Wir empfehlen ausschließlich die Verwendung von Fixed Pitch-Schriftarten wie
z.B. HOBLink 3270 oder Courier New.
4.2.1.9. ForeColor
Detaillierte Informationen sind in der Beschreibung der Visual Basic-Hilfe
verfügbar.
27
4.2.1.10. Function
Definiert die Funktionstaste, die bei Ausführen der Schaltfläche gesendet
wird, wenn ButtonType (Seite 27) angibt, daß die Schaltfläche eine
Funktionstaste sendet.
F
4.2.1.11. HideWhenNotPresent
Dieser Ausdruck gibt an, ob die HOB Control verborgen wird, wenn
HostText (Seite 28) an der mit PSCaptionStart (Seite 28) und
PSCaptionLength (Seite 28) angegebenen Position gefunden wird oder
nicht.
4.2.1.12. HostText
Wenn in diesem Feld Text eingetragen wird, müssen auch
PSCaptionStart (Seite 28) und PSCaptionLength (Seite 28) angegeben
werden. In diesem Fall vergleicht die Control den angegebenen Text mit
dem im Presentation Space an der mit PSCaptionStart angegebenen
Position gefundenen Text. Wenn der Text identisch ist, wird die Control
angezeigt. Anderenfalls wird die Control dargestellt wie in der
Eigenschaft HideWhenNotPresent (Seite 28) beschrieben.
4.2.1.13. Key
Bestimmt die Zeichenfolge, die bei Ausführen der Schaltfläche gesendet
wird, wenn ButtonType (Seite 27) angibt, daß die Schaltfläche eine
Zeichenfolge sendet. In diesem Fall müssen auch PSTextStart (Seite 28)
und PSTextLength (Seite 28) angegeben werden.
4.2.1.14. Macro
Gibt das Makro an, das bei Ausführen der Schaltfläche aufgerufen wird,
wenn ButtonType (Seite 27) angibt, daß die Schaltfläche ein Makro
startet.
i
Nur der Name wird als Parameter übergeben, um z.B. das Makro LOGON.MAC
aufzurufen, darf nur der LOGON als Parameter übergeben werden.
4.2.1.15. PSCaptionLength
Bei einer nicht-statischen Caption, d.h., daß der Caption-Text aus dem
Presentation Space übernommen wird. Diese Eigenschaft bestimmt die
Länge der Zeichen von PSCaptionStart (Seite 28).
4.2.1.16. PSCaptionStart
Bei einer nicht-statischen Caption, d.h., die Eigenschaft StaticCaption
(Seite 29) ist auf False gesetzt. Diese Eigenschaft gibt die Startposition
im Presentation Space an, von der der Text übernommen wird.
4.2.1.17. PSTextLength
Bestimmt entweder die Länge des Texts, der im Presentation Space
geschrieben wird, wenn die Control Text an den Host sendet, oder die
28
Länge des Texts der aus dem Presentation Space geholt und in der
Control angezeigt wird.
Nur für HOBButton Control
Diese Eigenschaft wird nur verwendet, wenn die Eigenschaft ButtonType
(Seite 27) auf hlKey (5.1. ActionType-Konstante, Seite 47) eingestellt ist.
Nur für HOBText Control
Diese Eigenschaft wird nur verwendet, wenn die Eigenschaft Linkage
(Seite 32) auf hlScreenPosition (5.11. LinkageTp-Konstante, Seite 49)
eingestellt ist.
4.2.1.18. PSTextStart
Bestimmt entweder die Startposition des Textes, der im Presentation
Space geschrieben wird, wenn die Control Text an den Host sendet, oder
die Startposition des Textes, der vom Presentation Space geholt und in
der Control angezeigt wird.
Nur für HOBButton Control
Diese Eigenschaft wird nur verwendet, wenn die Eigenschaft ButtonType
(Seite 27) auf hlKey (5.1. ActionType-Konstante, Seite 47) eingestellt ist.
Nur für HOBText Control
(Seite 32) auf hlScreenPosition (5.11. LinkageTp-Konstante, Seite 49)
eingestellt ist.
4.2.1.19. ScreenName
Diese Eigenschaft bestimmt, daß die Control nur gültig ist, wenn der
Host-Bildschirmname am Host der Eigenschaft der Control entspricht.
Bleibt dieses Feld ohne Eintrag, wird es permanent aktualisiert. Diese
Eigenschaft ist meistens erforderlich, wenn mehrere Bildschirme in einer
Visual Basic-Form kombiniert werden.
4.2.1.20. StaticCaption
Gibt an, ob der Caption-Text der Control der Eigenschaft Caption
(Seite 27) oder der im Presentation Space mit den Eigenschaften
PSCaptionStart (Seite 28) und PSCaptionLength (Seite 28) angegebene
Text verwendet wird.
4.2.1.21. SurfControl
Enthält den Namen der HOBSurf Control, mit der die Control kommuniziert. Die Standardeinstellung für Session A ist HOBSurf1.
4.2.1.22. UseHostColors
Dieser Ausdruck gibt an, ob die Control Host-Farben oder Visual BasicFarben verwendet.
4.2.1.23. WantHostKeys
Gibt an, ob die Control Host-Tasten an die Emulation sendet.
29
4.2.1.24. WriteAtPosition
Bestimmt die Position, an der Zeichen oder Zeichenfolgen geschrieben
werden, wenn die Eigenschaft ButtonType durch die Konstante hlKey
definiert wurde.
4.2.2. Methoden
4.2.2.1. SurfToScreen
F (Seite 25)
4.2.3. Ereignisse
4.2.3.1. Click
Tritt auf, wenn der Anwender eine Maustaste drückt oder losläßt,
während sich der Cursor über einem Objekt bewegt.
Dieses Ereignis tritt bei einer Control auf, wenn der Anwender:
• eine Control mit der linken oder rechten Maustaste klickt. Bei einer
HOBCheckBtn Control, HOBButton Control, HOBList Control oder
HOBRadio Control, tritt das Ereignis Click auf, wenn der Anwender
die linke Maustaste klickt.
• ein Element in einer HOBList Control oder HOBCombo Control wählt,
entweder durch Ausführen der Cursor-Tasten oder einen Klick auf die
linke Maustaste
• [Leer] drückt, wenn eine HOBButton, HOBRadio, oder HOBCheckBtn
Control gewählt ist.
• [ENTER] drückt, wenn in einer Form eine HOBButton Control vorhanden ist, deren Default-Eigenschaft auf True eingestellt ist.
• [Esc] drückt, wenn in einer Form eine HOBButton Control vorhanden
ist, deren Default-Eigenschaft auf True eingestellt ist.
• die Zugriffstaste einer Control ausführt, z.B., wenn der Caption einer
HOBButton Control "&Ausführen" ist, löst das Drücken von [ALT-A]
das Ereignis aus.
Das Ereignis Click kann auch mit einem Code ausgelöst werden, durch
• Einstellen der Value-Eigenschaft einer HOBRadio oder einer
HOBCheckBtn Control auf True.
4.2.3.2. DblClick
Tritt auf, wenn der Benutzer die Maustaste über einem Objekt drückt und
wieder losläßt und noch einmal drückt und wieder losläßt.
Bei einer Control tritt dieses Ereignis auf, wenn der Anwender:
• die linke Maustaste doppelklickt.
• ein Element in der HOBList Control oder HOBCombo Control doppelklickt.
4.2.3.3. KeyDown
Tritt auf, wenn der Anwender eine Taste drückt (KeyDown) während das
Objekt gewählt ist.
30
4.2.3.4. KeyPress
Tritt auf, wenn der Anwender eine ANSI-Taste drückt oder lösläßt
während das Objekt gewählt ist.
4.2.3.5. KeyUp
Tritt auf, wenn der Anwender eine Taste losläßt (KeyUp) während das
Objekt gewählt ist.
4.2.3.6. MouseDown
Tritt auf, wenn der Anwender eine Maustaste drückt.
4.2.3.7. MouseMove
Tritt auf, wenn der Benutzer die Maus bewegt.
4.2.3.8. MouseUp
Tritt auf, wenn der Anwender eine Maustaste losläßt (MouseUp).
31
4.3. HOBText Control
Die HOBText Control erzeugt in der Form eine Zeichenfolge mit HostEigenschaften.
4.3.1.1. Appearance
F (Seite 27)
4.3.1.2. AutoSkip
Dieser Ausdruck gibt an, ob der Cursor geschützte Felder überspringt
und im nächsten ungeschützten Feld positioniert wird.
4.3.1.3. BackColor
verfügbar.
4.3.1.4. DisableAID
F (Seite 27)
4.3.1.5. Enabled
F (Seite 27)
4.3.1.6. Font
F (Seite 27)
4.3.1.7. ForeColor
verfügbar.
4.3.1.8. FunctionNameOnEnter
FunctionNameOnEnter enthält eine Funktionstaste, die an den Host
gesendet wird, wenn der Anwender [Enter] drückt während die Control
gewählt ist.
F
4.3.1.9. Linkage
Stellt ein oder gibt zurück, welcher Text in der Control angezeigt wird. Es
kann entweder ein Textbereich im Presentation Space durch Position
und Länge oder ein komplettes Feld über dessen Numerierung von der
ersten Bildschirmposition an angegeben werden.
Wird der Text durch Position und Länge bestimmt, so sind die Eigenschaften PSTextStart (Seite 29) und PSTextLength (Seite 28) notwendig.
Wird hingegen der Text durch die Feldnumerierung bestimmt, muß die
Eigenschaft ScreenField (Seite 33) angegeben werden.
4.3.1.10. MultiLine
Gibt einen Wert zurück oder legt einen Wert fest, der angibt, ob eine
HOBText Control mehrere Zeilen Text akzeptieren und darstellen kann.
Zur Laufzeit schreibgeschützt.
32
4.3.1.11. NondisplayChar
Das hier definierte Zeichen wird verwendet, um den Text in dem Feld,
das der Control entspricht, zu verbergen. Ist dieses Feld leer, verbirgt die
Control den Text nicht.
4.3.1.12. Protected
Stellt ein oder gibt zurück, ob das angegebene Feld im Presentation
Space für diese Control geschützt ist oder nicht, d.h. ob der Anwender
Daten eingeben kann oder nicht.
i
Diese Eigenschaft gilt nur zur Laufzeit, d.h. ist das Feld zur Laufzeit nicht
geschützt, wird das Feld auf False gesetzt und der Anwender kann so Daten für
die Control eingeben.
4.3.1.13. PSTextLength
F (Seite 28)
F (Seite 29)
4.3.1.15. ScreenField
Stellt ein oder gibt zurück, von welchem Feld der Text aus dem
Presentation Space angezeigt wird.
(Seite 32) auf hlScreenField eingestellt ist.
F (Seite 29)
4.3.1.17. SelectTextOnFocus
Gibt an, ob der Text markiert erscheint oder nicht sobald dieses Feld
gewählt wird.
F (Seite 29)
4.3.1.19. Text
Gibt den Text im Bearbeitungsbereich einer HOBCombo Control
(Eigenschaft "Style" gleich 0 oder gleich 1) und einer HOBText Control
Control zurück oder legt ihn fest.
Gibt das ausgewählte Element im Listenfeld einer HOBCombo Control
(Eigenschaft "Style" gleich 2) zurück. Der zurückgegebene Wert
entspricht immer dem Wert, der von List(ListIndex) zurückgegeben wird.
Schreibgeschützt zur Entwurfszeit und zur Laufzeit.
F (Seite 29)
F (Seite 29)
33
4.3.2. Methoden
4.3.2.1. ChangeFieldProperties
Mit dieser Methode lassen sich die Eigenschaften ändern, die den
Ursprung des in der Control angezeigten Textes im Presentation Space
angeben.
4.3.2.2. Update
Mit diese Methode wird der Text einer HOBText Control im Presentation
Space geschrieben. Als optionaler Parameter kann anschließend eine
Funktionstaste gesendet werden.
F
4.3.3. Ereignisse
4.3.3.1. Change
Zeigt an, daß sich der Inhalt einer HOB Control geändert hat. Dieses
Ereignis tritt auf, wenn der Anwender den Text ändert oder wenn die
Einstellung der Eigenschaft Text (Seite 33) durch entsprechende
Programmierung geändert wird.
34
4.3.3.2. Click
F (Seite 30)
4.3.3.3. DblClick
F (Seite 30)
4.3.3.4. KeyDown
F (Seite 30)
4.3.3.5. KeyPress
F (Seite 31)
4.3.3.6. KeyUp
F (Seite 31)
4.3.3.7. MouseDown
F (Seite 31)
4.3.3.8. MouseMove
F (Seite 31)
4.3.3.9. MouseUp
F (Seite 31)
4.4. HOBList Control
Die HOBList Control erzeugt in der Form ein Listenfeld mit Host-Bildschirmeigenschaften.
4.4.1.1. Appearance
F (Seite 27)
4.4.1.2. DisableAID
F (Seite 27)
4.4.1.3. Enabled
F (Seite 27)
4.4.1.4. Font
F (Seite 27)
4.4.1.5. List
Gibt die Elemente, die Bestandteil der Liste einer HOBList Control oder
HOBCombo Control sind, zurück oder bestimmt sie. Die Liste ist ein
Datenfeld aus Zeichenfolgen, in dem jeder Eintrag ein Listenelement ist.
4.4.1.6. ListIndex
Gibt den Index des im Steuerelement momentan ausgewählten
Elements der Control zurück oder legt ihn fest.
4.4.1.7. ListWidth
Bestimmt die Breite (in Zeichen) der Liste, die aus dem Presentation
Space übernommen und in der Control dargestellt wird.
4.4.1.8. NoOfItems
Bestimmt die Anzahl Zeilen, die aus dem Presentation Space übernommen und in der Control dargestellt werden.
4.4.1.9. ScreenName
F (Seite 29)
4.4.1.10. StartColumn
Bestimmt die Startspalte im Presentation Space (beginnend mit Spalte
0), aus der die Elemente übernommen werden.
4.4.1.11. StartRow
Bestimmt die Startzeile im Presentation Space (beginnend mit Zeile 0),
aus der die Elemente übernommen werden.
F (Seite 29)
F (Seite 29)
35
4.4.2. Methoden
4.4.2.1. GetSelectionString
Gibt die gewählte Zeichenfolge aus einer Control zurück.
4.4.3. Ereignisse
36
4.4.3.1. Click
F (Seite 30)
4.4.3.2. DblClick
F (Seite 30)
4.4.3.3. KeyDown
F (Seite 30)
4.4.3.4. KeyPress
F (Seite 31)
4.4.3.5. KeyUp
F (Seite 31)
4.4.3.6. MouseDown
F (Seite 31)
4.4.3.7. MouseMove
F (Seite 31)
4.4.3.8. MouseUp
F (Seite 31)
4.5. HOBCheckBtn Control
Die HOBCheckBtn Control erzeugt eine CheckBox in der Form.
4.5.1.1. Alignment
Gibt den Wert zurück oder stellt ihn ein, der die Ausrichtung des Textes
in einer Control bestimmt. Zur Laufzeit schreibgeschützt.
4.5.1.2. BackColor
verfügbar.
4.5.1.3. Caption
F (Seite 27)
4.5.1.4. DisableAID
F (Seite 27)
4.5.1.5. Enabled
F (Seite 27)
4.5.1.6. Font
F (Seite 27)
4.5.1.7. ForeColor
verfügbar.
F (Seite 28)
4.5.1.9. HostText
F (Seite 28)
F (Seite 28)
F (Seite 28)
4.5.1.12. PSCheckedText
Der Text, der im Presentation Space geschrieben wird, wenn das
Element markiert ist. Die Position und Länge des Text wird mit den
Eigenschaften PSTextStart (Seite 29) und PSCheckedTextLength
(Seite 37) angegeben.
4.5.1.13. PSCheckedTextLength
Diese Eigenschaft gibt die Länge des Textes an, der mit den Eigenschaften PSCheckedText (Seite 37) und PSUncheckedText (Seite 37) im
Presentation Space geschrieben wird.
F (Seite 29)
4.5.1.15. PSUncheckedText
Der Text, der im Presentation Space geschrieben wird, wenn das
Element nicht markiert ist. Die Position und Länge des Text wird mit den
Eigenschaften PSTextStart (Seite 29) und PSCheckedTextLength
(Seite 37) angegeben
37
F (Seite 29)
F (Seite 29)
F (Seite 29)
F (Seite 29)
4.5.1.20. Value
Gibt den Zustand der Control zurück oder bestimmt ihn.
F (Seite 29)
4.5.2. Ereignisse
38
4.5.2.1. Click
F (Seite 30)
4.5.2.2. DblClick
F (Seite 30)
4.5.2.3. KeyDown
F (Seite 30)
4.5.2.4. KeyPress
F (Seite 31)
4.5.2.5. KeyUp
F (Seite 31)
4.5.2.6. MouseDown
F (Seite 31)
4.5.2.7. MouseMove
F (Seite 31)
4.5.2.8. MouseUp
F (Seite 31)
4.6. HOBRadio Control
Die HOBRadio Control erzeugt einen Radio Button in der Form.
4.6.1.1. Alignment+ (Seite 37)
4.6.1.2. BackColor
verfügbar.
4.6.1.3. Caption
F (Seite 27)
4.6.1.4. DisableAID
F (Seite 27)
4.6.1.5. Enabled
F (Seite 27)
4.6.1.6. Font
F (Seite 27)
4.6.1.7. ForeColor
verfügbar.
F (Seite 28)
4.6.1.9. HostText
F (Seite 28)
F (Seite 28)
F (Seite 28)
4.6.1.12. PSCheckedText
F (Seite 37)
4.6.1.13. PSCheckedTextLength
F (Seite 37)
F (Seite 29)
F (Seite 29)
F (Seite 29)
F (Seite 29)
F (Seite 29)
4.6.1.19. Value
F (Seite 38)
F (Seite 29)
39
4.6.2. Ereignisse
40
4.6.2.1. Click
F (Seite 30)
4.6.2.2. DblClick
F (Seite 30)
4.6.2.3. KeyDown
F (Seite 30)
4.6.2.4. KeyPress
F (Seite 31)
4.6.2.5. KeyUp
F (Seite 31)
4.6.2.6. MouseDown
F (Seite 31)
4.6.2.7. MouseMove
F (Seite 31)
4.6.2.8. MouseUp
F (Seite 31)
4.7. HOBCombo Control
Die HOBCombo Control erzeugt ein Kombinationsfeld in der Form.
4.7.1.1. DisableAID
F (Seite 27)
4.7.1.2. Enabled
F (Seite 27)
4.7.1.3. Font
F (Seite 27)
4.7.1.4. List
F (Seite 35)
4.7.1.5. ListIndex
F (Seite 35)
4.7.1.6. ListWidth
F (Seite 35)
4.7.1.7. NoOfItems
F (Seite 35)
4.7.1.8. ScreenName
F (Seite 29)
F (Seite 35)
4.7.1.10. StartRow
F (Seite 35)
4.7.1.11. Style
Gibt einen Wert zurück oder legt einen Wert fest, der den Typ der
HOBCombo Control und das Verhalten der zugehörigen ListenfeldKomponente angibt. Zur Laufzeit schreibgeschützt.
F (Seite 29)
4.7.1.13. Text
F (Seite 33)
F (Seite 29)
4.7.2. Methoden
4.7.2.1. GetSelectionString
F (Seite 36)
4.7.3. Ereignisse
4.7.3.1. Click
F (Seite 30)
4.7.3.2. DblClick
F (Seite 30)
4.7.3.3. KeyDown
F (Seite 30)
4.7.3.4. KeyPress
F (Seite 31)
4.7.3.5. KeyUp
F (Seite 31)
4.7.3.6. MouseDown
F (Seite 31)
4.7.3.7. MouseMove
F (Seite 31)
4.7.3.8. MouseUp
F (Seite 31)
41
4.8. HOBOia Control
Die HOBOia Control erzeugt eine Statusleiste, in denen nur Anwenderinformationen in Message Panes (Anzeigebereichen) angezeigt werden.
Der Anwender kann jedoch keine zusätzlichen Message Panes in der
Statusleiste erzeugen, außer denen die standardmäßig vorhanden sind.
Aus Gründen der Übersichtlichkeit werden die einzelnen Message Panes
entsprechend der Anordnung in der Statusleiste von links nach rechts
beschrieben.
Zur Verfügung stehen:
• APLPane
• CommErrorPane
• ConnectionPane
• InsertModePane
• MessageWaitingPane
• PrinterPane
• WaitPane
• XMessagePane
+ Weitere Hinweise in der OnLine-Hilfe
Klicken Sie in der Registerkarte Index auf das Hilfethema "HOBOia
Control".
Mittels der verfügbaren Eigenschaften können Sie einzelne Message
Panes der HOBOia Control einbinden oder entfernen.
4.8.1.1. APLPaneText
Gibt den Text (sichtbar oder unsichtbar) an, der im Anzeigebereich
erscheint.
i
Diese Eigenschaft kann nicht vom Anwender gesetzt werden.
4.8.1.2. CommErrorPaneText
erscheint.
i
4.8.1.3. ConnectionPaneText
erscheint.
i
42
F (Seite 27)
4.8.1.4. Font
4.8.1.5. InsertModePaneText
erscheint.
i
4.8.1.6. MessageWaitingPaneText
erscheint.
i
4.8.1.7. OIARefreshTime
Gibt den Zeitintervall zwischen jedem Aktualisierungsvorgang der
Statusleiste in Millisekunden an. Wird der Wert auf 0 gesetzt, wird die
Aktualisierung ausgesetzt, außer beim Erstellen der Control. In diesem
Fall muß der Anwender manuell aktualisieren mit der Methode Update
(Seite 25).
4.8.1.8. PrinterPaneText
erscheint.
i
4.8.1.9. ShowCommErrorPane
Zeigt den angegebenen Anzeigebereich in der Statusleiste an.
4.8.1.10. ShowAPLPane
4.8.1.11. ShowConnectionPane
4.8.1.12. ShowInsertModePane
4.8.1.13. ShowMessageWaitingPane
4.8.1.14. ShowPrinterPane
4.8.1.15. ShowWaitPane
4.8.1.16. ShowXMessagePane
43
4.8.1.17. Style
Bestimmt die Darstellungsart der HOBOia Control.
F (Seite 29)
4.8.1.19. WaitPaneText
erscheint.
i
4.8.1.20. XMessagePaneText
erscheint.
i
4.8.2. Methoden
F (Seite 25)
4.8.2.1. Update
4.8.3. Ereignisse
4.8.3.1. OnConnect
Dieses Ereignis liegt vor, wenn die Emulation erfolgreich eine HostVerbindung aufgebaut hat.
4.8.3.2. OnDisconnect
Dieses Ereignis liegt vor, wenn die Host-Verbindung der Emulation unterbrochen wurde.
44
4.9. HOBPS Control
Die HOBPS Control erzeugt ein Textfeld, in dem der aktuelle Bildschirminhalt der Emulation angezeigt wird. Diese Control wird standardmäßig
durch den HOBLink FaceLifter in die sogenannte Unlifted Form eingebunden, die nicht konvertierte Bildschirminhalte anzeigt.
4.9.1.1. AdditionalDelimiters
Bestimmt die Begrenzungszeichen (das sind zwei identischeZeichen, die
die Funktionstasten rechts und links umschließen, z.B. "_PF13_") im
Presentation Space, anhand derer Funktionstasten identifiziert und als
Schaltflächen dargestellt werden können.
4.9.1.2. CursorMovement
Bestimmt den Cursor-Modus, der verwendet wird.
4.9.1.3. Farbpalette
Die Farbeigenschaften stellen die Farben der dargestellten Zeichen ein,
d.h. wenn Zeichen am Host z.B. blau erscheinen, kann die Farbe auf
eine beliebige verfügbare Farbe umgestellt werden.
• Black
• Blue
• Green
• Red
• Turquoise
• Violet
• White
• Yellow
4.9.1.4. Font
F (Seite 27)
4.9.1.5. LimitView
Gibt einen eingeschränktern Anzeigebereich an, der aus dem
Presentation Space übernommen und in der Control dargestellt wird. Der
Anzeigebereich wird über die Spalten- bzw. Zeilenpositionen anhand der
Eigenschaften StartColumn (Seite 46), StartRow (Seite 46), StopColumn
(Seite 46) und StopRow (Seite 46) bestimmt.
4.9.1.6. OnTheFly
Gibt an, dass beim Vorfinden einer "unlifted Form" (d.h. eines
unerkannten Host-Bildschirms, der nicht guifiziert ist) dieser unmittelbar
guifiziert wird.
4.9.1.7. Selection
Bestimmt die Hintergrundfarbe des aktuell gewählten Felds. Wählen Sie
dazu in der angezeigten Farbpalette die gewünschte Farbe.
45
Bestimmt die erste Spalte im Presentation Space (beginnend mit
Spalte 0), aus der die Elemente übernommen werden.
4.9.1.9. StartRow
Bestimmt die erste Zeile im Presentation Space (beginnend mit
4.9.1.10. StopColumn
Bestimmt die letzte Spalte im Presentation Space (beginnend mit
4.9.1.11. StopRow
Bestimmt die letzte Zeile im Presentation Space (beginnend mit
46
+ (Seite 29)
HOBLink FaceLifter______________________________________________Konstanten
5
5. Konstanten
5.1. ActionType-Konstante
Die ActionType-Einstellungen für HOBButton Control sind:
Konstante
Wert
Beschreibung
hlFunction
0
hlKey
1
hlMacro
2
Die Schaltfläche sendet eine Funktionstaste. Die Eigenschaft Function (Seite 28)
muß eingestellt werden.
Die Schaltfläche sendet eine Zeichenfolge
an den Host. Die Eigenschaften Key
(Seite 28), PSTextStart (Seite 28) und
PSTextLength (Seite 28) müssen eingestellt werden.
Die Schaltfläche führt ein Makro in der
Emulation aus. Die Eigenschaft Macro
(Seite 28) muß eingestellt werden.
5.2. AppearanceStyle-Konstante
Die AppearanceStyle-Einstellungen für HOBText Control / HOBList
Control sind:
Konstante
Wert
Beschreibung
hlTextFlat
0
1
Die Control erscheint ohne Formattribute.
Die Control erscheint in 3D-Format.
hlText3D
5.3. BtnAppearanceStyle-Konstante
Die BtnAppearanceStyle-Einstellungen für HOBButton Control sind:
Konstante
Wert
Beschreibung
hlButtonNormal
0
hlButtonInset
1
Die Schaltfläche erscheint in 3D-Format
von Windows 95.
Die Schaltfläche erscheint so, als wäre Sie
in die Form versenkt.
47
Konstanten _____________________________________________ HOBLink FaceLifter
5.4. CheckValue-Konstante
Die CheckValue-Einstellungen für HOBCheckBtn Control und HOBRadio
Control sind:
Konstante
Wert
Beschreibung
hlUnchecked
0
1
Die Schaltfläche ist nicht markiert.
Die Schaltfläche ist markiert.
hlChecked
5.5. ComboStyle-Konstante
Die ComboStyle-Einstellungen für die HOBCombo Control sind:
Konstante
Wert
Beschreibung
hlDropdownCombo
0
hlSimpleCombo
1
hlDropdownList
2
Bestehend aus DropDown-Liste und Textfeld. Der Benutzer kann aus der Liste
auswählen oder einen Text im Textfeld
eingeben.
Bestehend aus Textfeld und Liste, die
immer angezeigt wird. Der Benutzer kann
aus der Liste auswählen oder einen Text
im Textfeld eingeben. Die Größe umfaßt
die Text- und die Listenkomponente.
Standardmäßig ist die Größe so
eingestellt, daß die Liste nicht sichtbar ist.
Vergrößern Sie die Height-Eigenschaft,
um einen größeren Teil der Liste
anzuzeigen.
Bewirkt, daß nur ein bereits in der Liste
vorhandener Eintrag vom Benutzer ausgewählt werden kann.
5.6. CursorMode-Konstante
Die CursorMode-Einstellungen für die HOBPS Control sind:
Konstante
Wert
Beschreibung
hlPSHostLike
0
Der Host-ähnliche Cursor-Modus wird
verwendet, der die Positionierung des Cursors
hlPSGUILike
1
auf geschützte und ungeschützte Felder zulässt.
Der GUI-ähnliche Cursor-Modus wird verwendet,
der die Positionierung des Cursors
ausschließlich auf ungeschützten Feldern
zulässt.
48
5.7. FKeyType-Konstante
Die FKeyType-Einstellungen für die HOBButton Control sind:
Konstante
Wert
Beschreibung
hl3270
0
Die Funktionstasten der HOBLink 3270-
hl5250
1
Emulation werden verwendet.
Die Funktionstasten der HOBLink 5250Emulation werden verwendet.
5.8. JustifyStyle-Konstante
Die JustifyStyle-Einstellungen sind:
Konstante
Wert
Beschreibung
hlTextLeft
0
1
Der Text in der Control ist linksbündig.
Der Text in der Control ist rechtsbündig.
hlTextRight
5.9. KeyIndex-Konstante
Die KeyIndex-Einstellungen für die HOBSurf Control sind wie folgt und
bezeichnen die jeweils angegebene Taste:
Konstante
Wert
hlKeyF1
0
hlKeyF2
1
hlKeyF3
2
hlKeyF4
3
hlKeyF5
4
hlKeyF6
5
hlKeyF7
6
hlKeyF8
7
hlKeyF9
8
hlKeyF10
9
hlKeyF11
10
hlKeyF12
11
hlKeyF13
12
hlKeyF14
13
hlKeyF15
14
hlKeyF16
15
hlKeyF17
16
hlKeyF18
17
hlKeyF19
18
hlKeyF20
19
hlKeyF21
20
hlKeyF22
21
hlKeyF23
22
hlKeyF24
23
hlKeyEnter
24
49
hlKeyNumEnter
25
hlKeyKeyInsert
26
hlKeyKeyHome
27
hlKeyPageUp
28
hlKeyDown
29
hlKeyPause
30
hlKeyEscape
31
hlKeyCtrl
32
hlKeyRightCtrl
33
5.10. KeyLevel-Konstante
Die KeyLevel-Einstellungen für die HOBSurf Control sind wie folgt und
bezeichnen die jeweils angegebene Taste:
Konstante
Wert
hlBaseKeyLevel
0
hlShiftKeyLevel
1
hlCtrlKeyLevel
2
hlAltKeyLevel
3
hlAllKeyLevels
4
5.11. LinkageTp-Konstante
Die LinkageTp-Einstellungen für HOBText control sind:
Konstante
Wert
hlScreenPosition 0
hlScreenField
1
Beschreibung
Der angezeigte Text in der Control wird
durch Position und Länge eines Bereiches
der Presentation Space bestimmt.
Der angezeigte Text in der Control wird
durch Numerierung der Felder der
Presentation Space bestimmt.
5.12. PositionType-Konstante
Die PositionType-Einstellungen für die HOBButton Control sind:
Konstante
Wert
Beschreibung
hlCurrent
0
Die Zeichen/Zeichenfolge wird an die aktuelle
hlSpecified
1
Cursor-Position geschrieben.
Die Zeichen/Zeichenfolge wird an die
angegebene Position geschrieben. In diesem
Fall müssen auchPSTextStart und
PSTextLength angegeben werden.
50
5.13. SbStyle-Konstante
Die SbStyle-Einstellungen für HOBOia control sind:
Konstante
Wert
Beschreibung
hlSbLowered
0
hlSbFlat
1
hlSbRaised
2
Die Control erscheint in die Oberfläche
vertieft.
Die Control erscheint eben in der Oberfläche eingebettet.
Die Control erscheint hervorgehoben in
der Oberfläche.
51
52
HOBLink FaceLifter________ Identifizieren, Hinzufügen und Löschen von HOB Controls
6
6. Identifizieren, Hinzufügen und Löschen von HOB
Controls
6.1. HOB Controls identifizieren
Sie haben - wie in der OnLine-Hilfe des HOBLink FaceLifters
beschrieben - die GUI-Form einer Host-Anwendung erstellt.
Sobald die GUI-Form erstellt ist, wird Microsoft Visual Basic ausgeführt.
Die Form besteht komplett aus unterschiedlichen Objekt-Controls. Alle in
der Form vorhandenen Controls sind HOB Controls, die bearbeitet und
geändert werden können. Alle HOB Controls werden der Werkzeugsammlung von Visual Basic hinzugefügt,
HOB Control
Schaltfläche
HOBSurf Control
HOBButton Control
HOBText Control
HOBList Control
HOBChkBtn Control
HOBRadio Control
HOBOia Control
HOBCombo Control
HOBPS Control
Abbildung 22: HOB Controls in der Visual Basic-Werkzeugsammlung
Wie Sie HOB Controls identifizieren und bearbeiten
Um herauszufinden, welchem Control-Typ ein Objekt in der Form
entspricht, gehen Sie wie folgt vor:
1.
2.
i
Gewünschte HOB Control anklicken.
[F4] drücken. Das Dialogfeld Eigenschaften erscheint. Der erste
Eintrag in diesem Dialogfeld zeigt den vorhandenen Control-Typ.
Die nachfolgenden Zeilen enthalten eine Aufstellung aller für das
Objekt verfügbaren Eigenschaften und ihre aktuelle Einstellungen.
Für die benutzerfreundliche Eingabe, können Sie alle relevanten Einträge auch
im Registerkartenformat anzeigen lassen. Um in diese Darstellungsart umzuschalten, doppelklicken Sie auf (Benutzerdefiniert).
3.
Einstellungen der HOB Control wie gewünscht ändern.
53
Identifizieren, Hinzufügen und Löschen von HOB Controls________ HOBLink FaceLifter
6.2. HOB Controls hinzufügen
Wie Sie HOB Controls hinzufügen
i
1.
Gewünschte HOB Control in der Werkzeugsammlung
doppelklicken. Die gewählte HOB Control wird der Form
hinzugefügt.
2.
2. Falls erforderlich, Größe der Control anpassen.
3.
[F4] drücken. Das Dialogfeld Eigenschaften erscheint.
Für die benutzerfreundliche Eingabe, können Sie alle relevanten Einträge auch
im Registerkartenformat anzeigen lassen. Um in diese Darstellungsart umzuschalten, doppelklicken Sie auf (Benutzerdefiniert).
3.
Einstellungen der HOB Control wie gewünscht ändern.
6.3. HOB Controls löschen
Wie Sie HOB Controls löschen
1.
2.
54
Wählen Sie die gewünschte HOB Control.
Drücken Sie [Entf], um die Control zu löschen.
HOBLink FaceLifter_______________________________________ Verfügbare Tokens
Anhang
Verfügbare Tokens
Die folgende Aufstellung zeigt die Tastenbeschreibungen und die dazugehörigen Tokens:
Tastenbeschreibung
Token
Attention
Backspace
Back Tab
Backtab Word
Clear Screen
Close Session
Cursor Down
Cursor Left
Cursor Right
Cursor Select
Cursor Up
Delete Character
Delete Word
Dup Field
Edit Clear
Edit Copy
Edit Cut
Edit Paste
Edit Undo
End Field
Enter
Erase EOF
Erase Field
Erase Input
Fast Cursor Down
Fast Cursor Left
Fast Cursor Up
Fast Cursor Right
Field Mark
Home
Insert Toggle
Mark Down
Mark Left
Mark Right
Mark Up
Move Mark Down
Move Mark Left
Move Mark Right
Move Mark Up
New Line
sys attn
backspace
backtab
backtab word
clear
close
down
left
right
cursor select
up
delete char
delete word
dup
edit-clear
edit-copy
edit-cut
edit-paste
edit-undo
end field
enter
erase eof
erase field
erase input
fast down
fast left
fast up
fast right
field mark
home
insert
mark down
mark left
mark right
mark up
move down
move left
move right
move up
newline
55
Verfügbare Tokens _______________________________________ HOBLink FaceLifter
Print Screen
Program Attention Key 1
Program Function Key 1
:
:
Program Function Key 24
Reset
Rule (enables/disables the ruler)
System Request
Tab Field
Tab Word
Unmark
Wait Input Inhibit
56
local copy
pa1
pa2
pa3
pf1
:
:
pf24
reset
rule
sys req
tab field
tab word
unmark
wait inp inh
HOBLink FaceLifter______________________________________ Stichwortverzeichnis
Stichwortverzeichnis
*
E
*.FRM · 18
*.HLF · 23
*.HLK · 23
*.HSP · 13; 19
*.HSS · 9; 13; 19
*.OCX · 20
*.VBP · 8
A
AdditionalDelimiters · 47
Alignment · 38; 40
APLPaneText · 44
Appearance · 28; 33; 36
Aufbau und Zielgruppe (Benutzerhandbuch) · 6
AutoEnter · 28
AutomaticCloseEmulation · 22
AutomaticHideEmulation · 22
AutomaticStartEmulation · 22
AutoSkip · 33
B
BackColor · 33; 38; 40
ButtonType · 28
C
Caption · 28; 38; 40
Change · 35
ChangeFieldProperties · 35
ClearKeyLevel · 25
Click · 31; 35; 37; 39; 41; 43
CommErrorPaneText · 44
Connect · 24
ConnectionPaneText · 44
CursorMovement · 47
D
DblClick · 31; 35; 37; 39; 41; 43
DefaultHostQuietTime · 23
DisableAID · 28; 33; 36; 38; 40; 42
DisableKeyBuffer · 23
Eigenschaften
HOBButton Control · 28
HOBCheckBtn Control · 38
HOBCombo Control · 42
HOBList Control · 36
HOBOia Control · 44
HOBPS Control · 47
HOBRadio Control · 40
HOBSurf Control · 22
HOBText Control · 33
Eigenschaften, Methoden und Ereignisse der
HOB Controls · 22
Einführung · 7
Emulation · 23
Enabled · 28; 33; 36; 38; 40; 42
Ereignisse
F
Farbpalette · 47
FKeysType · 28
Font · 28; 33; 36; 38; 40; 42; 45; 47
ForeColor · 28; 33; 38; 40
FormTable · 23
Function · 29
FunctionNameOnEnter · 33
G
GetCurrentScreenName · 25
GetCursor · 25
GetSelectionString · 37; 43
GetText · 25
GetTextEx · 25
H
HideEmulation · 25
HideWhenNotPresent · 29; 38; 40
HlkFile · 23
HOB Controls hinzufügen · 57
57
Stichwortverzeichnis______________________________________ HOBLink FaceLifter
HOB Controls identifizieren · 56
HOB Controls in Visual Basic · 20
HOB Controls in Visual Basic verwenden · 21
HOB Controls löschen · 57
HOBLink FaceLifter-Schaltflächen
Beenden · 17
Hilfe · 17
Info · 17
Mehrere Forms · 9
Neue Form · 8
Neues Projekt · 8
Optionen · 11
Projekt öffnen · 8
Projekt speichern · 8
Projektinfo · 9
Visual Basic · 11
HOBPS Control · 47
HostPathsFile · 24
HostScreensFile · 24
HostText · 29; 38; 40
LimitView · 47
Linkage · 33
List · 36; 42
ListIndex · 36; 42
ListWidth · 36; 42
M
Macro · 29
MaximumTimeToWait · 24
MessageWaitingPaneText · 45
Methoden
MouseDown · 32; 35; 37; 39; 41; 43
MouseMove · 32; 35; 37; 39; 41; 43
MouseUp · 32; 35; 37; 39; 41; 43
MultiLine · 33
N
NondisplayChar · 34
NoOfItems · 36; 42
I
Identifizieren, Hinzufügen und Löschen von
HOB Controls · 56
Initialize · 25
InsertModePaneText · 45
K
Key · 29
KeyDown · 31; 35; 37; 39; 41; 43
KeyPress · 32; 35; 37; 39; 41; 43
KeyUp · 32; 35; 37; 39; 41; 43
Konstanten · 49
ActionType · 49
AppearanceStyle · 49
BtnAppearanceStyle · 49
CheckValue · 50
ComboStyle · 50
CursorMode · 50
FKeyType · 51
JustifyStyle · 51
KeyIndex · 51
KeyLevel · 52
LinkageTp · 52
PositionType · 52
SbStyle · 54
Konvertierung mit dem HOBLink FaceLifter · 7
58
L
O
OIARefreshTime · 45
OnConnect · 46
OnDisconnect · 46
OnError · 27
OnLine-Hilfe · 6
OnLine-Hilfe starten · 6
OnScreenChange · 27
OnScreenUpdated · 27
OnTheFly · 47
Optionen
Registerkarte Allgemein · 11
Registerkarte Andere Eigenschaften · 15
Registerkarte Formeinstellungen · 13
Registerkarte HOBSurf Eigenschaften · 14
Registerkarte Verbindung · 12; 13
P
PrinterPaneText · 45
Protected · 34
PSCaptionLength · 29; 38; 40
PSCaptionStart · 29; 38; 40
HOBLink FaceLifter______________________________________ Stichwortverzeichnis
PSCheckedText · 38; 40
PSCheckedTextLength · 38; 40
PSTextLength · 29; 34
PSTextStart · 30; 34; 39; 40
PSUncheckedText · 39
V
Value · 39; 40
Verfügbare Tokens · 59
W
R
RemoveTrailingChars · 24
S
ScreenField · 34
ScreenName · 30; 34; 36; 39; 40; 42
Selection · 47
SelectTextOnFocus · 34
SendKey · 25
SendMacro · 26
SendText · 26
Session · 24
SetCursor · 26
SetKeyMappingLevel · 26
ShowAPLPane · 45
ShowCommErrorPane · 45
ShowConnectionPane · 45
ShowEmulation · 26
ShowInsertModePane · 45
ShowMessageWaitingPane · 45
ShowPrinterPane · 45
ShowWaitPane · 45
ShowXMessagePane · 46
StartColumn · 36; 42; 48
StartRow · 36; 42; 48
StartScreenUpdate · 26
StaticCaption · 30; 39; 40
StopColumn · 48
StopRow · 48
StopScreenUpdate · 26
Style · 42; 46
SurfControl · 30; 34; 36; 39; 40; 43; 46; 48
SurfToScreen · 26; 31
Symbole und Konventionen · 5
WaitHostQuiet · 27
WaitPaneText · 46
WantHostKeys · 30; 34; 36; 39; 40; 43
Wie Sie den HOBLink FaceLifter konfigurieren ·
17
Wie Sie ein Projekt anderen Anwendern
zugänglich machen · 19
Wie Sie HOB Controls identifizieren und
bearbeiten · 56
Wie Sie HOB Controls löschen · 57
Wie Sie Host-Anwendungen in graphische
Benutzeroberflächen konvertieren · 18
WriteAtPosition · 31
X
XMessagePaneText · 46
T
Text · 34; 43
U
UnliftedForm · 24
Update · 26; 35; 46
UseHostColors · 30; 34; 39; 40
59
Stichwortverzeichnis______________________________________ HOBLink FaceLifter
60
HOBLink FaceLifter_____________________________________Abbildungsverzeichnis
Abbildungsverzeichnis
Abbildung 1: HOBLink FaceLifter ....................................................................................7
Abbildung 2: Neues Projekt .............................................................................................8
Abbildung 3: Projekt öffnen .............................................................................................8
Abbildung 4: Projekt speichern ........................................................................................8
Abbildung 5: Neue Form .................................................................................................8
Abbildung 6: Mehrere Forms ...........................................................................................9
Abbildung 7: Dialogfeld Mehrere Forms ..........................................................................9
Abbildung 8: Projektinfo ..................................................................................................9
Abbildung 9: Dialogfeld Projektinfo..................................................................................9
Abbildung 10: Visual Basic ............................................................................................10
Abbildung 11: Optionen.................................................................................................10
Abbildung 12: Optionen - Registerkarte "Allgemein" ......................................................10
Abbildung 13: Optionen - Registerkarte "Verbindung"....................................................11
Abbildung 14: Optionen - Registerkarte "Schriftarten"....................................................12
Abbildung 15: Optionen - Registerkarte "Formeinstellungen".........................................12
Abbildung 16: Optionen - Registerkarte "HOBSurf Eigenschaften" ................................13
Abbildung 17: Optionen - Registerkarte "Andere Eigenschaften" ...................................14
Abbildung 18: Info .........................................................................................................16
Abbildung 19: Hilfe........................................................................................................16
Abbildung 20: Beenden .................................................................................................16
Abbildung 21: Verbindung zwischen HOBLink 3270 und Visual Basic............................19
Abbildung 22: HOB Controls in der Visual Basic-Werkzeugsammlung...........................53
61

Version 2.2

Transcription

Documents pareils

Lahn di au - Vocalensemble Kreuz und Quer

Whitepaper HOB Remote Desktop VPN

Giuliani-Flexibilität in den USA Giuliani flexibility in the USA

6 Tipps zum Erstellen einer iPhone / Android Seite 6.1 Name und

girocard / EAPS

Visual Kei - transcript Verlag

HOBLink J-DRDA

Technische Daten - Technical Data

IO-Link-Master - Bosch Rexroth