English | Français | Deutsch

LINKPROGRAMMIERUNG

Die Linkprogrammierung beschäftigt sich mit der strukturiert programmierbaren Anzeige von Dateien (Projektseiten, Textdateien, Bilder, Video usw).  Während der Programmierung können Ausführungsparameter festgelegt werden. Wir werden mit Hilfe eines einfachen Beispiels demonstrieren, wie man Links definiert und in Projekt einsetzt. Momentan können nur Projektseiten gelinkt werden. Das Linken von externen Dateien ist bei dem momentanen Stand der Technologie nicht möglich.

» Aufgabebeschreibung
Ein Dokumentensystem mit sechs Seiten soll erstellt werden. Die Startseite ist so aufzubauen, dass dem Anwender 5 Links zur Verfügung gestellt werden, um auf Dokumentdateien zu gelangen. Für die Erstellung von Dokumentdateien wird die Komponente, die für Projekt „Demo_Partition“ angelegt und bearbeitet wurde, als Muster verwendet. Nur das Bild dieser Komponente wird für jede Dokumentdatei neu bestimmt. Der Anwender soll auch die Möglichkeit haben, zurück zur Startseite zu kommen.

» Neues Projekt und neue Zielseite öffnen
Setzen Sie die erste Seite des Projektes mit der Überschrift „Demo_Dokument“ als aktiv. Nach der erfolgreichen Aktivierung dieser Seite, wird das Projekt „Demo_Dokument“ auch aktiviert.

» Aufbau der Startseite

1. Legen Sie die Komponente [TPartitionContainer, Container & Frame] an
2. Stellen Sie [TPartitionContainer] mit Hilfe der folgenden Tabelle ein:

Eigenschaftsname	Beschreibung	Einstellungswert
<StyleM>	Bestimmt, welche Partitionen angezeigt werden müssen	ArrangeM_CTB (siehe nächste Abbildung)
<TopAutoSize>	Bestimmt, ob die Höhe der oberen Partition automatisch berechnet wird oder nicht	True
<BottomAutoSize>	Bestimmt, ob die Höhe der untere Partition automatisch berechnet wird oder nicht	True
<SpaceHorz>	Horizontaler Abstand zwischen 2 Partitionen	0
<SpaceVert>	Vertiktaler Abstand zwischen 2 Partitionen	0
<TopOrigin>	Ausgabeposition einer Verknüpfungskomponente relativ zur oberen Partition	(0, 0)
<BottomOrigin>	Ausgabeposition einer Verknüpfungskomponente relativ zur unteren Partition	(0, 0)
<ClientOrigin>	Ausgabeposition einer Verknüpfungskomponente relativ zur Klient-Partition	(0, 0)
<X-Draw & Y-Draw>	Ausgabeposition von [TPartitionContainer]	(20, 20)

1. Legen Sie die Komponente [TProStaticText, Standard] an und zwar auf der oberen Partition von [TPartitionContainer]
2. Stellen Sie [TProStaticText] mit Hilfe der folgenden Tabelle ein:

Eigenschaftsname	Beschreibung	Einstellungswert
<Text>	Anzeigetext	Mein Dokumentssystem
<TextAlign>	Textausrichtung	txt_Center
<Font>	Textschrift	Schriftname: Arial Black Schriftgröße: 24 Stil: Fett Farbe: Farbenpalette „Studio“, 6 Spalten für die Farbentabelle, Zeile 5, Spalte 6

1. Legen Sie die Komponente [TTextField, Standard] an und zwar auf der Klient-Partition von [TPartitionContainer]
2. Stellen Sie [TTextField] mit Hilfe der folgenden Tabelle ein:

Eigenschaftsname	Beschreibung	Einstellungswert
<Text>	Anzeigetext	Kopieren Sie den Einführungstext dieses Kapitel und fügen Sie diesen Text durch die Menüfunktion Bearbeiten►Einfügen►Text
<Font>	Textschrift	Schriftname: Times New Roman Schriftgröße: 12 Farbe: Farbenpalette „Studio“, 6 Spalten für die Farbentabelle, Zeile 41, Spalte 6

 

Partitionierung bestimmen

1. Legen Sie die Komponente [TButtonLabList, standard] an und zwar auf der unteren Partition von [TPartitionContainer]
2. Eigenschaft <Font> von [TButtonLabList] mit mit fogenden Werten bearbeiten:  [Schriftname: Times New Roman; Schriftgröße:12; Stil: Unterstrichen; Farbe: Farbenpalette „Studio“, 6 Spalten für die Farbentabelle, Zeile 14, Spalte 6]
3. Führen Sie  Überschrift erstellen des Lokalmenüs aus und weisen Sie der markierten Komponente einen Name zu. Dafür die Eigenschaft <ObjectName> bearbeiten
4. Doppelklick auf eine Überschrift, um den Text einzugeben. Geben Sie dann „Datei 1“, „Datei 2“, „Datei 3“, „Datei 4“ und „Datei 5“ ein

ACHTUNG

Bei der Link- und Eventprogrammierung müssen Komponenten eindeutige Namen aufweisen. Befinden sich in einer Projektseite 2 Komponenten mit dem gleichen Name, können die programmierten Links und Events nicht aktiviert werden. Ein Meldungsfehler wird dementsprechend angezeigt.

» Muster für weitere Seiten kopieren

1. Zunächst das aktuelle Projekt speichern
2. Erste Seite des Projektes „Demo_Partition“ öffnen
3. Die im Abschnitt Paritionsdesign erstellte Komponente markieren, indem ein der kleinsten grünen Rechtecke angeklickt wird.
4. Menüfunktion Bearbeiten►Kopieren►Objekt ausführen

» Aufbau von weiteren Seiten
Für die übrig gebliebenen Seiten des Projektes „Demo_Dokument“ (mindestens 5 in der Zahl) sind folgende Schritte durchzuführen:

1. Entsprechende Seite öffnen
2. Menüfunktion Bearbeiten►Einfügen►Objekt ausführen
3. Die Komponenten {Zemprosys, Technology, Development, Products, Support, Contact} mit eindeutigen Namen umbenennen. Dafür die Eigenschaft <ObjectName> bearbeiten
4. Bild anklicken
5. Eigenschaft <BgFileImage> bestimmen (Die Seiten sollen unterschiedliche Bilder bekommen)

» Links ins Projekt einfügen
Zum Einfügen von Links dient die folgende Tabelle als Planungstabelle

	Titel	Typ /Dateityp	Quelleseite /Dateiname	Parameter
1	Startseite	Projektseite	Page-43	Kein
2	Dokument 1	Projektseite	Page-44	Kein
3	Dokument 2	Projektseite	Page-45	Kein
4	Dokument 3	Projektseite	Page-46	Kein
5	Dokument 4	Projektseite	Page-47	Kein
6	Dokument 5	Projektseite	Page-48	Kein

(Die Namen der Quelleseiten können unterschiedlich sein und hängen davon ab, wie die Seiten während der Erstellung benannt wurden) 

1. Um Links zu definieren, müssen Sie Linkexpress mit Hilfe der Schaltfläche  aktivieren
2. Führen Sie die Funktion  aus, um neues Link ins Projekt einzufügen.  Geben Sie dann unten im Feld Titel den Text „Startseite“ ein und drücken Sie anschließend ENTER. Wiederholen Sie den Schritt für Dokument 1 bis 5 (also nochmals 5 weiteren Links ins Projekt einfügen. Siehe nächste Abbildung)

Aktuelles Projekt mit 6 eingetragenen Links

» Type der eingefügten Links festlegen

1. Markieren Sie einen Link-Eintrag der Aktionsliste und öffnen Sie dann das Thema Typ
2. Wählen Sie dann den Typ „Projektseite“

(Wiederholen Sie diese Schritte für alle anderen Einträge)

» Quelleseiten festlegen

1. Markieren Sie einen Link-Eintrag der Aktionsliste und öffnen Sie dann das Thema Dateiname
2. Schaltfläche Ändern aktivieren. Der Inspektor wird geöffnet, um den Name der Quelledatei zu bearbeiten. Die obige Planungstabelle dient als Hilfsmittel, um die richtige Quelledatei zu bestimmen
3. Wiederholen Sie diese Schritte für alle anderen Einträge und achten Sie darauf, dass die Quelledateien richtig festgelegt werden

» Startseite des Dokumentssystems mit Links verknüpfen
Die eingefügten und bearbeiteten Links sind noch wirkungslos, weil sie noch nicht mit Komponenten verknüpft worden sind. Die Frage, wann ein Link ausgeführt werden soll, ist noch nicht beantwortet worden.

ACHTUNG

Wenn diese Meldung (siehe nächste Abbildung) eingeblendet wird, müssen Sie die Benennung von Komponenten der aktuellen Seite nochmals durchführen. Mit Hilfe der Eigenschaft <ObjectName> kann eine Komponente umbenennt werden.

Meldung über duplizierte Komponentennamen

 

1. Startseite des Dokumentssystems öffnen und die Komponente mit der Überschrift „Datei 1“ markieren
2. Eigenschaft <Command> wählen und Seitenlinks des Befehlsregisters aktivieren
3. Zeilen mit Überschrift „Dokument 1“ markieren und Registerfunktion Aktion einfügen ausführen  (siehe nächste Abbildung)
4. Verknüpfen Sie die anderen Komponenten (Datei 2, Datei 3, Datei 4 und Datei 5) auf die gleiche Vorgehensweise

Verknüpfung eines Link mit der Eigenschaft <Command> einer Komponente

» Andere Seiten des Dokumentssystems mit Links verknüpfen
Die Links der Startseite können schon ausgeführt werden, aber der Anwender soll die Möglichkeit haben, zur Startseite zurück zu kommen, wenn er ein Link der Startseite aktiviert hat.

1. Projektseite des Dokumentssystems mit dem Titel „Dokument 1“ (siehe Planungstabelle) öffnen und die Komponente {Zemprosys} markieren bzw. die größere Überschrift „Zemprosys“ anklicken
2. Eigenschaft <Command> wählen und Seitenlinks des Befehlsregisters aktivieren
3. Zeilen mit Überschrift „Startseite“ markieren und Registerfunktion Aktion einfügen ausführen
4. Verknüpfen Sie die anderen Projektseiten (Dokument 2, Dokument 3, Dokument 4 und Dokument 5) auf die gleiche Weise. Für alle Verknüpfungen muss immer die Zeile mit der Überschrift „Startseite“ als Aktion gewählt werden.

» Test durchführen
Schalten Sie den Testmodus  ein (am bestens Gesamtbild) und testen Sie das Dokumentssystem

1. Link Datei 1 aktivieren
2. Link Datei 2 aktivieren
3. Link Datei 3 aktivieren
4. Link Datei 4 aktivieren
5. Link Datei 5 aktivieren

(Um zur Startseite zurückzukommen, aktiviert man Zemprosys ganz oben)

» Wie wird ein Link erstellt?

	Schritte	Beschreibung
1	Aktionsliste	Der erste Schritt ist die Erzeugung eines neuen Links, das ins Projekt eingefügt wird. Ein generierter Link-Eintrag hängt weder von einer Projektseite noch von einer Komponente ab
2	Typ	Es existiert viele Type von Links. Daher ist es notwendig, den Typ eines Links zu fixieren. Wird der Typ nicht festgelegt, ist das Link unbekannt und kann daher weder bearbeitet noch ausgeführt werden
3	Dateiname	Der Dateiname bestimmt die Quelledatei. Eine Quelledatei repräsentiert die Datei, die angezeigt oder ausgführt wird. Gewöhnliche Quelledateien sind Projektseiten
4	Parameter	Einige Link-Kategorien werden mit Parameter ausgeführt. Die Bearbeitung von Parametern erfolgt auf die gleiche Weise, wie Komponenteneigenschaften bzw. Methodenparameter eingestellt werden
5	Aktivierung	Weil ein Link unabhängig von einer Komponente erzeugt und bearbeitet wird, muss es aktiviert werden, damit es während der Laufzeit ausgeführt werden kann. Bei der Aktivierung bestimmt man der Sender des Links. Der Sender repräsentiert eine Komponente, die die Ausführung des Links einleiten soll. Die Senderbestimmung, auch als Autorisationsverfahren genannt, kann auf einen der folgenden Wege realisiert werden: (a) Direkt über die Eigenschaft <Command> einer Komponente. Diese Vorgehensweise wurde bereits oben erläutert. (b) Indirekt durch die Funktion Link aktivieren des Linkexpress (siehe Abschnitt „Funktionen des Linkexpresses“) (c) Indirekt über den Parameter <Command> einer Datenstruktur. Es existieren solche Komponenten, die mehrere Befehle verwalten und solche Befehle lassen sich nur über Methodenparameter bearbeiten (weitere Informationen zu diesem Thema werden im Abschnitt Eventprogrammierung gegeben)

 

» Funktionen des Linkexpresses
Der Linkexpress ist mit einer Vielzahl von Funktionen gerüstet, die die Administration von Projekt-Links unterstützen. In den folgenden Tabellen, sind alle dieser Funktionen beschrieben.

Dateiname
Ändern	Festlegung bzw. Änderung des Dateinamens der Quelledatei (Vertknüpfungsdatei). Soll beispielsweise eine Projektseite angezeigt werden, dann kann man über den Inspektor diese Projektseite visualisieren und wählen
Aufheben	Annuliert die Verknüpfung zwischen dem markierten Link der Aktionsliste und der Quelledatei
Öffnen	Öffnet die Quelledatei des markierten Links. Nicht alle Link-Kategorien lassen sich hier öffnen
Neue Datei	Erzeugt eine neue Quelledatei und verknüpft sie mit dem markierten Link der Aktionsliste. Nicht alle Link-Kategorien lassen diese Funktion zu. In der Regel können nur Projektdateien und Projektseiten erstellt werden.
Befehlseditor	Leitet die Bearbeitung der Eigenschaft <Command> der markierten Komponente ein

 

Aktionsliste
Weitere Funktionen		Zeigt ein Lokalmenü für weitere Funktionen an: Numerierung: Ein- und Ausblenden von Zeilennummern Ansicht: Zeigt nur einen bestimmten Typ von Einträgen an
Bearbeiten	Bestätigrn	Änderung an dem Titel eines Links bestätigen. Auch mit ENTER lässt sich diese Funktion aktivieren
	Suchen	Suchen nach einem bestimmten Link-Eintrag. Dien Suche beginnt am Anfang der Liste.
	Suchen	Suchen nach einem bestimmten Link-Eintrag. Dien Suche beginnt ab aktueller Markierung der Liste. Ist beispielsweise die aktuelle Markierung die Zeile 4, beginnt die Suche tatsächlich in Zeile 5 und vorwärst
	Titel	Feld zum Ändern eines Link-Titels. Dieser Titel wird als Überschrift während der Ausführung des Links angezeigt
	Suchen	Suchwort. Bei der Suche wird dieses Wort mit dem Titel eines Links verglichen
Extras	Link aktivieren	Markiertes Link der Aktionsliste mit Komponente verknüpfen, damit es ausgeführt werden kann
	Aktivierungsliste	Zeigt die Liste der Verknüpfungskomponenten, die autorisiert sind, das markierte Link auszuführen. Mehrere Komponenten können ein und daselbe Link ausführen
	Öffnen	Öffnet die Quelledatei des markierten Links. Nicht alle Link-Kategorien lassen sich hier öffnen Hinweise Durch Mausbewegung auf Einträge der Aktionsliste, wird rechts die gleiche Funktion angezeigt, sofern ein Eintrag schon mit einer Quelledatei verknüpft ist. Durch Klick auf das eingeblendete Bild, öffnet man ebenfalls die Quelledatei
	Anweisungskette	Standardmäßig kann eine Komponente mehrere Links zugleich ausführen. In diesem Zusammenhang zeigt diese Funktion alle Link-Einträge, die von der markierten Komponente ausgeführt werden. Diese Liste wird anhand des kleinen Bilds neben dem Link-Titel identifiziert und zwar werden alle Einträge, die mit der markierten Komponente verknüpfen sind, mit  versehen.
	Befehlseditor	Leitet die Bearbeitung der Eigenschaft <Command> der markierten Komponente ein.

 

SCHRITTE DES TUTORIALS
01	02	03	04	05	06	07	08	09	10	11	12	13	14	15	16	17	18	19	20

 

© 2008 Zemprosys Group The power of innovation www.zemprosys.com