English | Français | Deutsch
English | Français | Deutsch
EINFÜHRUNG IN ZEMPROSYS |
|||
| Inhaltsverzeichnis » | Linkprogrammierung | ||
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
- Legen Sie die Komponente [TPartitionContainer, Container & Frame] an
- 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)
- Legen Sie die Komponente [TProStaticText, Standard] an und zwar auf der oberen Partition von [TPartitionContainer]
- 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
- Legen Sie die Komponente [TTextField, Standard] an und zwar auf der Klient-Partition von [TPartitionContainer]
- 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
- Legen Sie die Komponente [TButtonLabList, standard] an und zwar auf der unteren Partition von [TPartitionContainer]
- 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]
- Führen Sie Überschrift erstellen des Lokalmenüs aus und weisen Sie der markierten Komponente einen Name zu. Dafür die Eigenschaft <ObjectName> bearbeiten
- 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
» Aufbau von weiteren Seiten
Für die übrig gebliebenen Seiten des Projektes „Demo_Dokument“ (mindestens 5 in der Zahl) sind folgende Schritte durchzuführen:
- Entsprechende Seite öffnen
- Menüfunktion Bearbeiten►Einfügen►Objekt ausführen
- Die Komponenten {Zemprosys, Technology, Development, Products, Support, Contact} mit eindeutigen Namen umbenennen. Dafür die Eigenschaft <ObjectName> bearbeiten
- Bild anklicken
- 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)
- Um Links zu definieren, müssen Sie Linkexpress
mit Hilfe der Schaltfläche aktivieren
- 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
- Markieren Sie einen Link-Eintrag der Aktionsliste und öffnen Sie dann das Thema Typ
- Wählen Sie dann den Typ „Projektseite“
(Wiederholen Sie diese Schritte für alle anderen Einträge)
» Quelleseiten festlegen
- Markieren Sie einen Link-Eintrag der Aktionsliste und öffnen Sie dann das Thema Dateiname
- 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
- 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
- Startseite des Dokumentssystems öffnen und die Komponente mit der Überschrift „Datei 1“ markieren
- Eigenschaft <Command> wählen und Seitenlinks des Befehlsregisters aktivieren
- Zeilen mit Überschrift „Dokument 1“ markieren und Registerfunktion Aktion einfügen ausführen (siehe nächste Abbildung)
- 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.
- Projektseite des Dokumentssystems mit dem Titel „Dokument 1“ (siehe Planungstabelle) öffnen und die Komponente {Zemprosys} markieren bzw. die größere Überschrift „Zemprosys“ anklicken
- Eigenschaft <Command> wählen und Seitenlinks des Befehlsregisters aktivieren
- Zeilen mit Überschrift „Startseite“ markieren und Registerfunktion Aktion einfügen ausführen
- 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
- Link Datei 1 aktivieren
- Link Datei 2 aktivieren
- Link Datei 3 aktivieren
- Link Datei 4 aktivieren
- 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
Ö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
Leitet die Bearbeitung der Eigenschaft <Command> der markierten Komponente ein.
SCHRITTE DES TUTORIALS
