I S T

INPA-SCREEN-TOOL V1.0

Bedienungsanleitung

Stand: 01.09.95

Pioneer Produkt-Entwicklung GmbH

Fasanenstraße 108

82008 Unterhaching

Michael Antesberger


Einführung

Das INPA-SCREEN-Tool (IST) dient der schnellen und bequemen Nachbesserung einzelner Elemente (Funktionen) für die Bildschirmausgabe (z. B. textout(), analogout(), etc.) in INPA-Dateien (*.ips) bzw. in Prae-INPA-Dateien (*.src).

Die gleichwertige Unterstützung von Maus und Tastatur erlaubt es, die Eigenschaften der Ausgabe-Elemente (wie zum Beispiel Textposition, Textattribute etc.) beliebig definierter SCREEN-Funktionen mit wenigen Handgriffen zu ändern. Diese Änderungen können in zwei Entwicklungsfenstern gleichzeitig durchgeführt und beobachtet werden.

Ein Fenster gibt den aktuell bearbeiteten INPA-Source-Code aus, das zweite Fenster stellt die Ausgabe-Elemente graphisch dar, entsprechend ihrer Originalgröße und -position im Ausgabefenster des INPA-Interpreters bzw. des INPA-Runtime-Systems.

Der bisher notwendige, mühsame Prozeß

- INPA-Source laden

- Zahlenwerte (z. B. Textposition) verändern

- INPA-Source speichern

- INPA-Interpreter starten

- Veränderungen im INPA-Ausgabefenster kontrollieren

- Wiederholen bis... (z. B. die Textposition stimmt).

reduziert sich auf einen einmaligen Vorgang

- INPA-Source laden

- Ausgabe-Element mit der Maus anklicken und an die richtige Position schieben.

- INPA-Source speichern.

- fertig.

Besonders erleichtert wird die Arbeit mit Prä-INPA-Dateien (*.src-Dateien). Parallel zu der aktuellen Datei können mehrere Texttabellen (*.txt-Dateien) geladen werden. Die Veränderungen in der Darstellung, die sich durch unterschiedliche Text-Übersetzungstabellen ergeben, sind sofort ersichtlich und können augenblicklich korrigiert werden. Der bisher übliche, mühsame und zeitraubende Weg über das Makro-Ersetzungsprogramm und den INPA-Interpreter entfällt vollständig.

Darüber hinaus vermeidet die IST-Oberfläche unabsichtliche Syntaxfehler. Das entnervende Wiedereinlesen-und-Ausbessern fällt somit ebenfalls weg.

Vom Benutzter definierte zusätzliche Ausgabe-Elemente lassen sich schnell und einfach integrieren.

Die strukturellen Eigenschaften der INPA-Dateien (Leerzeilen, Kommentare etc.) bleiben erhalten, das heißt nichteditierte Programme werden vom INPA-SCREEN-Tool unverändert abgespeichert.

Da es sich bei diesem Programm um ein Tool zur Nachbearbeitung von INPA-Dateien handelt, werden im Folgenden Grundkenntnisse im Umgang mit der INPA-Programmiersprache vorausgesetzt.


Inhaltsverzeichnis

Einführung

Inhaltsverzeichnis

1 Installation und Start

2 Arbeiten mit dem INPA-SCREEN-Tool

2.1 Die Basisfunktionen des IST im Überblick

2.2 Beschreibung der Basisfunktionen

2.2.1 Datei-Menü

2.2.1.1 Datei laden

2.2.1.2 Datei speichern

2.2.1.3 Datei speichern als...

2.2.1.4 Programm beenden

2.2.2 Text-Tabellen-Menü

2.2.2.1 Tabelle Laden

2.2.2.2 Tabellen-Liste

2.2.2.3 Tabellen entfernen

2.2.3 SCREEN-Liste

2.2.4 Hilfe-Menü

2.2.4.1 Hilfe

2.2.4.2 Inhalt

2.2.4.3 Hilfe verwenden

2.2.4.4 Info

2.3 Die Bearbeitung von SCREEN-Funktionen

2.3.1 Vorbemerkungen

2.3.2 Arbeiten mit dem Edit-Fenster

2.3.3 Arbeiten mit dem View-Fenster

2.3.4 Arbeiten mit den Edit-Dialogboxen

2.3.5 Editierbare und nicht-editierbare Funktionsparameter

2.4 Die Konfigurationsdatei inpa_ist.ini

2.4.1 Vorbemerkungen

2.4.2 Fenstereinstellungen

2.4.3 Dateinamen

2.4.4 Benutzer-definierte Funktionen

2.4.5 Beispiel für eine korrekte Konfigurationsdatei:

3 Literatur


Installation und Start
1 Installation und Start

Kopieren Sie die Archivdatei ist_arc.exe in das Verzeichnis, in dem die Anwendung installiert werden soll, und starten dort die Archivdatei. Die Datei erzeugt dabei automatisch den erforderlichen Verzeichnisbaum (siehe auch die beiliegende readme-Datei read!!!.me). Das ausführbare Programm inpa_ist.exe befindet sich dann im Unterverzeichnis .\INPA_IST\EXE, und kann dort von der Windows-Oberfläche wie jede ausführbare Datei gestartet werden.


Arbeiten mit dem INPA-SCREEN-Tool
2 Arbeiten mit dem INPA-SCREEN-Tool

2.1 Die Basisfunktionen des IST im Überblick

Bild 1: Hauptfenster der Anwendung.

Unmittelbar nach dem Starten des Programms erscheint das Hauptfenster, das gerade groß genug ist, um die Menüzeile und eine Symbolleiste anzuzeigen (Bild 1).

Die vollständige Menüstruktur ergibt sich wie folgt:

Datei

   Laden (F3 bzw. ).

   Speichern (F2 bzw. ).

   Speichern als... ( [image]).

   Programm beenden (Alt+F4)

Text-Tabelle

   Tabelle Laden (F7 bzw. ).

   Tabellen-Liste (F5)

   Tabellen Entfernen

SCREEN-Liste ( [image]).

Hilfe

   Hilfe-Datei

   Inhalt ( [image]).

   Hilfe verwenden

...Info ( [image]).

Die wichtigsten Funktionen sind über Funktionstasten oder per Maus-Klick von der Symbolleiste aus erreichbar. Beispielsweise kann der Menüpunkt Datei Laden kann auch mit der Taste F3, oder durch einen Maus-Klick auf das Symbol [image] ausgeführt werden.


Beschreibung der Basisfunktionen
2.2 Beschreibung der Basisfunktionen

2.2.1 Datei-Menü

2.2.1.1 Datei laden

Die Auswahl der INPA-Dateien (*.ips) und Prä-INPA-Dateien (*.src) findet mit dem Windows-Standard-Dialog Datei laden statt. Das INPA-SCREEN-Tool muß dann zum Einlesen die ausgewählte Datei in ein internes Format übersetzen, um die Nachbearbeitung zu ermöglichen. Treten Übersetzungsfehler auf, wird der Ladevorgang abgebrochen und eine Warnung ausgegeben. Im Anschluß daran öffnet das Programm eine Protokolldatei, die über Art und Anzahl der aufgetretenen Lesefehler informiert. Das Protokoll-Fenster kann mit den Tasten Alt+F4 wieder geschlossen werden.

Die Fehler-Protokolldatei wird grundsätzlich bei jedem Ladevorgang erzeugt, unmittelbar nach korrektem Einlesen jedoch wieder gelöscht. Sie befindet sich immer im gleichen Verzeichnis wie die aktuelle Source-Datei.

Hinweis: Wegen des Übersetzungsprozesses dauert das Einlesen einer Source-Datei deutlich länger als das Sichern der Datei.

Am Dateimenü wird eine Liste der (maximal 5) zuletzt bearbeiteten Dateien angehängt. Über diese Liste kann die jeweilige Datei ohne langes Suchen rasch wieder geladen werden. Die Dateiliste wird in der Konfigurationsdatei inpa_ist.ini abgespeichert (s. a. Kap. 2.4), und steht Ihnen auch in späteren Sitzungen wieder zur Verfügung.

2.2.1.2 Datei speichern

Die aktuelle Source-Datei wird abgespeichert. Der Dateiname kann hier nicht verändert werden. Die bisher gültige Source-Datei wird überschrieben.

2.2.1.3 Datei speichern als...

Vor dem Speichern wird der Dateiname mit dem Windows-Standard-Dialog Datei speichern ausgewählt. Ab diesem Zeitpunkt gilt dann der neue Dateiname für die aktuelle Source-Datei.

2.2.1.4 Programm beenden

Die Anwendung wird beendet. Vor dem Beenden wird grundsätzlich nachgefragt, ob der Anwender das Programm auch wirklich beenden will. Wenn die aktuelle Source-Datei seit dem letzten Abspeichern verändert wurde, kann die Datei bei Bedarf vor dem Beenden noch gesichert werden.


Text-Tabellen-Menü
2.2.2 Text-Tabellen-Menü

2.2.2.1 Tabelle Laden

Das Einlesen von Texttabellen (*.txt) findet wie beim Laden von Source-Dateien mit dem Windows-Standard-Dialog Datei laden statt. Da für die Übersetzung einer Prä-INPA-Datei (*.src) in eine INPA-Source-Datei (*.ips) oft mehrere Tabellen erforderlich sind, dürfen sich bis zu 5 Tabellen gleichzeitig im Speicher befinden. Mit Hilfe der Texttabellen werden die Makro Texte (Texte der Form @Makro-Name@) in den zugehörigen Tabelleneintrag übersetzt.

Für jede Prä-INPA-Datei wird normalerweise ein eigener Text-Tabellen-Satz verwendet. Daher werden alle Texttabellen vor jedem Neuladen einer INPA-Datei automatisch aus dem Speicher entfernt.

Wie am Dateimenü wird auch am Texttabellen-Menü eine Liste der zuletzt verwendeten Tabellen angehängt. Dies erleichtert den Zugriff auf die Basistabellen. Die Texttabellen-Liste wird in der Konfigurationsdatei inpa_ist.ini gesichert (s. a. Kap. 2.4).

2.2.2.2 Tabellen-Liste

Eine Liste der aktuell geladenen Tabellen wird ausgegeben.

2.2.2.3 Tabellen entfernen

Alle aktuell geladenen Tabellen werden aus dem Speicher entfernt.


SCREEN-Liste
2.2.3 SCREEN-Liste

Mit diesem Menüpunkt wird ein SCREEN-Auswahl-Fenster geöffnet (Bild 2). Eine Liste aller SCREEN-Funktionen der aktuell geladenen Source-Datei wird ausgegeben. Mit der Maus (Scroll-Bar, Doppelklick) oder mit der Tastatur (Bild, Bild, ,  und ) kann nun eine SCREEN-Funktion zum Bearbeiten ausgewählt werden. Nach der Auswahl schließt sich dieses Fenster wieder, und es werden zwei weitere Fenster geöffnet, in denen dann die aktuell gewählte SCREEN-Funktion bearbeitet werden kann (s. a. Kap. 2.3). Ort u. Größe des Fensters können beliebig eingestellt werden. Diese Einstellungen werden in der Konfigurationsdatei inpa_ist.ini gesichert (s. a. Kap. 2.4).

Bild 2: Das SCREEN-Auswahl-Fenster.


Hilfe-Menü
2.2.4 Hilfe-Menü

2.2.4.1 Hilfe

Die Hilfedatei kann von Anfang an gelesen werden.

2.2.4.2 Inhalt

Das Inhaltsverzeichnis der Hilfedatei wird ausgegeben.

2.2.4.3 Hilfe verwenden

Das Inhaltsverzeichnis der Windows-Hilfedatei wird ausgegeben.

2.2.4.4 Info

Die Info-Box des INPA-SCREEN-Tools wird ausgegeben.


Die Bearbeitung von SCREEN-Funktionen
2.3 Die Bearbeitung von SCREEN-Funktionen

2.3.1 Vorbemerkungen

Nach der Auswahl einer SCREEN-Funktion werden zwei Fenster geöffnet, ein Edit-Fenster und ein View-Fenster. Beide Fenster erfüllen im wesentlichen die gleichen Aufgaben. Sie geben die aktuelle SCREEN-Funktion aus, und sie stellen Maus- und Tastaturfunktionen bereit zur Auswahl und Bearbeitung der Ausgabe-Elemente. Das View-Fenster gibt jedoch den INPA-Source-Code (Programmtext) der aktuellen SCREEN-Funktion aus (Bild 3).

Bild 3: Im View-Fenster wird der aktuell bearbeitete Source-Code dargestellt.

Das Edit-Fenster simuliert das Ausgabefenster des INPA-Interpreters (bzw. des INPA-Runtime-Systems), und stellt die Ausgabe-Elemente als Rechtecke dar, die der Position und Größe des Original-Elementes entsprechen (vgl. Bild 4a und b)

Mit der Tabulator-Taste kann zwischen dem View-Fenster und dem Edit-Fenster hin- und hergeschaltet werden. Die Betätigung der ESC-Taste oder der Tastenkombination Alt+F4 beendet die SCREEN-Bearbeitung, und beide Fenster werden wieder geschlossen. Mit der Tastenkombination Strg+Tabulator gelangt der Benutzer von beiden Fenstern aus  in das Haupt-Fenster. Vom Haupt-Fenster aus wird mit der Kombination Strg+Tabulator grundsätzlich in das Edit-Fenster verzweigt (falls vorhanden).

1/2>>

Bild 4a Das Edit-Fenster simuliert die Ausgabe-Elemente.

Bild 4b: Zum Vergleich das Original mit dem INPA-Interpreter.

<<2/2


Arbeiten mit dem Edit-Fenster
2.3.2 Arbeiten mit dem Edit-Fenster

Das Edit-Fenster kann an eine beliebige Position auf dem Bildschirm verschoben werden. Die Größe läßt sich nicht verändern. Die eingestellten Koordinaten werden in der Konfigurationsdatei inpa_ist.ini gesichert (s. a. Kap. 2.4).

Mit den Cursortasten  und  wird die Ausgabe eines SCREENS um eine LINE nach oben bzw. nach unten verschoben. Mit den Tasten Bild und Bild verschiebt sich die Ausgabe um eine Seite. Die Textausgabe im View-Window bleibt dadurch unbeeinflußt.

Das Anwählen eines Ausgabe-Elementes zum Bearbeiten erfolgt entweder durch einmaliges Anklicken mit der Maus, oder mit den Cursortasten  und . Das angewählte Element wird mit einem dicken Rand dargestellt. Bei jedem Anwählen wird die Textausgabe im ViewWindow nachgeführt, so daß dort stets der Source-Code des aktuell bearbeiteten Elementes zu sehen ist.

Durch wiederholtes Anklicken und Ziehen der Maus (drag-and-drop; den Maus-Knopf beim Ziehen bitte gedrückt lassen) läßt sich das Ausgabe-Element verschieben. Beim Loslassen des Maus-Knopfes werden die neuen Koordinaten direkt in den INPA-Source-Code übernommen.

Wird das Ausgabe-Element mit einem Maus-Doppelklick angewählt, öffnet sich eine Dialogbox, in der die Eigenschaften des Ausgabe-Elementes (z. B. Textposition) direkt geändert werden können (s. a. Kap. 2.3.4).

Ist bereits ein Element angewählt, läßt sich die zugehörige Dialogbox auch durch Betätigen der RETURN-Taste () öffnen.

Hinweis: Die Positionsverschiebung eines Ausgabe-Elementes hat nur dann eine Wirkung, wenn der jeweilige Positionsparameter editierbar ist (siehe dazu unbedingt Kap. 2.3.5).


Arbeiten mit dem View-Fenster
2.3.3 Arbeiten mit dem View-Fenster

Ort und Größe des View-Fensters können beliebig eingestellt werden. Auch diese Einstellungen werden in der Konfigurationsdatei inpa_ist.ini gesichert (siehe Kap. 2.4).

Analog zum Edit-Fenster kann hier die Textausgabe mit den Cursor-Tasten  und  um eine Zeile nach oben bzw. nach unten verschoben werden. Mit den Tasten Bild und Bild verschiebt sich die Ausgabe um eine Seite. Die Graphikausgabe im Edit-Window bleibt dadurch unbeeinflußt.

Das Anwählen eines Ausgabe-Elementes zum Bearbeiten erfolgt wie im Edit-Fenster entweder durch einmaliges Anklicken mit der Maus oder mit den Cursor-Tasten  und . Das angewählte Element wird invers dargestellt. Bei jedem Anwählen wird die Graphikausgabe im Edit-Window nachgeführt, so daß stets eine Kontrolle der Größe und der Position des aktuell bearbeiteten Elementes möglich ist.

Die Edit-Dialogboxen (siehe dazu Kap. 2.3.4) können auch hier wie im Edit-Fenster mit der RETURN-Taste () und mit einem Maus-Doppelklick erreicht werden.


Arbeiten mit den Edit-Dialogboxen
2.3.4 Arbeiten mit den Edit-Dialogboxen

Für jedes Ausgabe-Element existiert eine entsprechende Dialogbox (Bild 5), in der die Eigenschaften des Elementes direkt verändert werden können (hier: Horizontale und vertikale Position, auszugebender Text sowie Font und Textattribute).

Bild 5: Dialogbox des Ausgabe-Elementes ftextout().

Für Benutzer-definierte Ausgabe-Elemente (siehe Kap. 2.4.4) existiert eine allgemeine Dialogbox, die automatisch an das jeweilige Ausgabe-Element angepaßt wird.

Hinweis: Die Veränderungen an editierbaren und nicht-editierbaren Parametern haben unterschiedliche Wirkungen (siehe dazu unbedingt Kap. 2.3.5).


Editierbare und nicht-editierbare Funktionsparameter
2.3.5 Editierbare und nicht-editierbare Funktionsparameter

Editierbare Parameter sind nur Zahlenwerte und in Anführungszeichen eingeschlossene Texte. Nur in diesen Fällen ist das INPA-SCREEN-Tool in der Lage, den Wert des übergebenen Parameters (z. B. die horizontale Position) zu ermitteln (Beispiel a). Veränderungen an editierbaren Parametern werden beim Abspeichern berücksichtigt.

Beispiele:

a.) text(3 , 5, Beispieltext);

b.) text(y , x, text_variable);

c.) text(3, 4 + x, Hier wird Beispieltext Nr. + i +  ausgegeben.);

In Beispiel a sind somit alle Parameter editierbar, in Beispiel b dagegen gibt es keine editierbaren Parameter. In Beispiel c ist nur der erste Parameter editierbar.

Nicht-editierbare Parameter sind Variablennamen (Beispiel b) oder Kombinationen aus Variablennamen und Werten (Beispiel c). Der tatsächliche Wert des jeweiligen Parameters kann nun nicht mehr ermittelt werden (vgl. Beispiel b: sowohl die Textposition als auch der auszugebende Text sind für das INPA-SCREEN-Tool unbekannt).

Um einen vernünftigen Abgleich der Ausgabe-Elemente zueinander durchführen zu können, werden für diese Parameter Dummy-Werte erzeugt, das heißt:

Nicht-editierbare Zahlenparameter werden mit 0 belegt. Das Ausgabe-Element in Beispiel b wird somit an der Position (0;0) ausgegeben, das Ausgabe-Element in Beispiel c an der Position (0;3).

Ist ein Textparameter nicht editierbar, wird statt dessen der Name des Textparameters verwendet und ausgegeben. Zum Bearbeiten einer Source-Datei (*.src oder *.ips) können die voreingestellten Werte zwar verändert werden, die Auswirkungen der Veränderung beschränken sich jedoch auf die Darstellung im Graphik-Fenster. Der tatsächliche Source-Code bleibt in diesem Falle unberührt, und ändert sich demzufolge auch im View-Fenster nicht!

Veränderungen an nicht-editierbaren Parametern dienen ausschließlich als Darstellungshilfe und werden daher auch beim Abspeichern nicht berücksichtigt (drum heißen sie so...)!

Der Benutzer kann also beispielsweise den tatsächlichen Inhalt der Variablen text_variable (im Beispiel b) so einstellen, wie er es im realen Programmablauf erwarten würde, und die anderen Ausgabe-Elemente dementsprechend ausrichten. Die Variable text_variable im Source-Code bleibt jedoch erhalten.


Die Konfigurationsdatei inpa_ist.ini
2.4 Die Konfigurationsdatei inpa_ist.ini

2.4.1 Vorbemerkungen

Das INPA-SCREEN-Tool liest unmittelbar nach dem Start die Konfigurationsdatei inpa_ist.ini und übernimmt die dort abgespeicherten Informationen. Die Datei wird zunächst im aktuellen Windows-Verzeichnis gesucht und dann im aktuellen Verzeichnis des INPA-SCREEN-Tools. Ohne Konfigurationsdatei wird die Anwendung mit Standard-Einstellungen gestartet.

Die Konfigurationsdatei wird vor dem Beenden des Programms aktualisiert, bzw. -falls sie noch nicht existiert- neu erstellt. Sie befindet sich dann grundsätzlich im aktuellen Windows-Verzeichnis.

2.4.2 Fenstereinstellungen

Die Gruppe der Fenstereinstellungen beginnt mit dem Schlüsselwort [WinGeometry]. Folgende Informationen werden dort abgespeichert:

- Größe und Position des SCREEN-Auswahl-Fensters

- Größe und Position des View-Fensters

- Position des Edit-Fensters

2.4.3 Dateinamen

Am Popup-Menü Datei bzw. am Popup-Menü Text-Tabelle wird jeweils eine Liste der (bis zu 5) zuletzt bearbeiteten Dateien angehängt. Diese Listen werden laufend aktualisiert und vor dem Beenden in der Gruppe [SourceFiles] beziehungsweise in der Gruppe [TableFiles] gesichert.


Benutzer-definierte Funktionen
2.4.4 Benutzer-definierte Funktionen

In der Gruppe [INPAFunctions] hat der Benutzer die Möglichkeit, eigene Ausgabefunktionen zu definieren. Dafür werden folgende Parameter zur Verfügung gestellt:

Name=beispielfunktion	: Name der zusätzlichen Funktion

parameter=5	: Anzahl der Funktionsparameter

paramX=2	: Nummer des Parameters, der für die horizontale

  Position zuständig ist.

paramY=3	: Nummer des Parameters, der für die vertikale

  Position zuständig ist.

paramText=1	: Nummer des Parameters, der den auszugebenden Text

  beinhaltet.

paramFont=0	: Nummer des Parameters, der den Font-Wert beinhaltet.

paramAttrib=0	: Nummer des Parameters, der die Textattribute

  beinhaltet.

paramLength=1	: Nummer des Parameters, der für die aktuelle Länge des

  Ausgabe-Elementes zuständig ist.

paramHeight=0	: Nummer des Parameters, der für die aktuelle Höhe des

  Ausgabe-Elementes zuständig ist.

fixedText=Text	: Ausgabetext wird fest gewählt.

fixedFont=0	: Fest eingestellter Font für die Textausgabe.

fixedAttrib=0	: Fest eingestellte Text-Attribute (unterstreichen, etc.).

fixedX=0	: Horizontale, Position des Elementes (Spalte).

fixedY=0	: Vertikale Position des Elementes (Zeile).

fixedLength=0	: Länge des Elementes (in Spalten).

fixedHeight=0	: Höhe des Elementes (in Zeilen).

Um ein korrektes Bearbeiten dieser neu definierten Funktionen zu ermöglichen sind jedoch einige Regeln zu beachten:

1/2>>

•


Mindestens der Funktionsname sowie die Anzahl der Funktionsparameter jedes neu definierten Elementes müssen angegeben werden! Stimmt die Parameter-Anzahl nicht mit dem Wert Parameter überein, kann die Funktion nicht korrekt bearbeitet werden. Alle INPA-Dateien, in denen diese Funktion verwendet wird, sind daher nicht mehr lesbar, und das INPA-SCREEN-Tool gibt eine Fehlermeldung aus.

•	Alle anderen Werte sind optional, das heißt sie können angegeben werden, müssen aber nicht. Alle nicht-angegebenen Werte werden automatisch auf 0 gesetzt und bleiben dann unberücksichtigt.

•	Werte mit dem Präfix param bezeichnen die Parameter-Nummer. Gezählt wird von links nach rechts, beginnend mit 1! (siehe Beispiele). Werte mit dem Präfix fixed werden absolut angegeben (z. B. fixedX=3: Das Ausgabeelement befindet sich grundsätzlich in der dritten Spalte). Diese Werte können während des Programmablaufs NICHT verändert werden!

•	Es dürfen keine widersprüchlichen Kombinationen angegeben werden! Im obigen Beispiel wird der Funktionsparameter Nr. 1 doppelt angegeben. Zum einen soll er den ausgegebenen Text beinhalten (paramText=1), zum anderen die Länge des Ausgabe-Elementes (paramLength=1). In diesem Falle kann kein korrekter Programmablauf garantiert werden!

•	Bei Text, Font und Attributen haben die Größen param die Priorität. Wenn dieser Parameter nicht belegt ist, werden die fixed-Größen untersucht. Sind diese ebenfalls unbenutzt, werden die Default-Werte verwendet (Als Text wird der Funktionsname ausgegeben; die Werte für Font und Attribute werden jeweils auf 0 gesetzt).

•	Geben Sie sich keine Mühe, irgendwelche Kommentartexte in die Konfigurationsdatei einzufügen. Diese werden erbarmungslos wieder wegrationalisiert!

<<2/2

Beispiele:


Beispiele:

Das INPA-SCREEN-Tool soll eine zusätzliche Beispielfunktion bearbeiten können. Diese Funktion gibt einen Text aus und verwendet 5 Parameter:

- Der Name der neuen Funktion sei beispiel'.

- Der auszugebende Text wird im 1. Parameter übergeben.

- Die horizontale Textposition wird im 2. Parameter übergeben.

- Die vertikale Position wird im 3. Parameter übergeben.

- Die Parameter 4 und 5 seien irgendwelche Werte.

Ein (möglicher) Funktionsaufruf wäre dann:

beispiel(BUH!, 3, 4, Hallo Du Da!, 2);

Beispiel a)	Name=beispiel

   parameter=5

   paramX=2

   paramY=3

   paramText=1

   paramFont=0

   paramAttrib=0

   paramLength=0

   paramHeight=0

   fixedText=

   fixedFont=0

   fixedAttrib=0

   fixedX=0

   fixedY=0

   fixedLength=0

   fixedHeight=0

Eigenschaften:

Die ersten drei Parameter sind mit dem INPA-SCREEN-Tool erreichbar, und können bearbeitet werden. Die Länge des Elementes im Graphik-Fenster ergibt sich aus der Länge des Textparameters.

1/3>>


Beispiel b)	Name=beispiel

   parameter=5

   paramX=0

   paramY=3

   paramText=1

   paramFont=0

   paramAttrib=0

   paramLength=0

   paramHeight=0

   fixedText=

   fixedFont=0

   fixedAttrib=0

   fixedX=30

   fixedY=0

   fixedLength=0

   fixedHeight=0

Eigenschaften:

Der Parameter für die horizontale Position ist nicht erreichbar. Der Text wird stets in der 30. Spalte ausgegeben. Entlang der Y-Achse kann der Text jedoch wie oben verschoben werden.

Beispiel c)	Name=beispiel

   parameter=5

   paramX=2

   paramY=3

   paramText=1

   paramFont=0

   paramAttrib=0

   paramLength=0

   paramHeight=0

   fixedText=

   fixedFont=0

   fixedAttrib=0

   fixedX=0

   fixedY=0

   fixedLength=5

   fixedHeight=0

Eigenschaften: Der Text wird wie in Beispiel a behandelt. Das umschließende Rechteck ist jedoch stets 5 Spalten lang.

<<2/3>>


Beispiel d)	Name=beispiel

   parameter=5

   paramX=2

   paramY=3

   paramText=1

   paramAttrib=0

   paramLength=5

   fixedX=0

   fixedY=0

   fixedLength=0

   fixedHeight=0

Eigenschaften: Die Länge des Ausgabe-Elementes ergibt sich aus dem Wert, der als 5. Parameter übergeben wird. Sonst verhält sich die Funktion wie in Beispiel a und c. Die Fehlenden Parameter werden mit 0 (bzw. ) vorbelegt, und werden beim Beenden der Applikation entsprechend ergänzt.

Beispiel e)	Name=beispiel

   parameter=5

   paramX=2

   paramY=3

   paramText=1

   paramFont=0

   paramAttrib=0

   paramLength=5

   paramHeight=0

   fixedText=

   fixedFont=0

   fixedAttrib=0

   fixedX=0

   fixedY=0

   fixedLength=5

   fixedHeight=0

Eigenschaften: Fehlerhafte Definition! Die Länge des Ausgabe-Elementes ist nicht mehr eindeutig bestimmbar!

<<3/3


Beispiel für eine korrekte Konfigurationsdatei:
2.4.5 Beispiel für eine korrekte Konfigurationsdatei:

[WinGeometry]

ScrWin.X=809

ScrWin.Y=203

ScrWin.W=211

ScrWin.H=190

ViewWin.X=3

ViewWin.Y=544

ViewWin.W=640

ViewWin.H=197

EditWin.X=3

EditWin.Y=101

[TableFiles]

Table=C:\DEVELOP\INPA\KLIMA_5B.TXT

Table=C:\DEVELOP\INPA\FG38.TXT

Table=C:\DEVELOP\INPA\MUSTER.TXT

Table=C:\DEVELOP\INPA\INPA_WB.TXT

[SourceFiles]

File=C:\DEVELOP\INPA\FG38.IPS

File=C:\DEVELOP\INPA\BAE.IPS

File=C:\DEVELOP\INPA\TEST\BUH.IPS

File=C:\DEVELOP\INPA\DEBUG.IPS

File=C:\DEVELOP\INPA\TEST\ZAE.IPS

[INPAFunctions]

Name=ausgabe_speicher

   Parameter=2

   paramX=0

   paramY=0

   paramText=0

   paramFont=0

   paramAttrib=0

   paramLength=0

   paramHeight=0

   fixedText=

   fixedFont=0

   fixedAttrib=0

   fixedX=3

   fixedY=2

   fixedLength=10

   fixedHeight=3


Literatur
3 Literatur

[1] Entwicklungssystem für Prüfabläufe - Funktionale Spezifikation Fa. Softing GmbH

[2] Benutzer-Dokumentation zum Interpreter für Prüfabläufe INPA Fa. Softing GmbH