TREEVIEW
|
Syntax: |
TREEVIEW([<WAIT|NOWAIT>, <Exit-Makro>,
<Split-Windowcall-Handle>],
<Array>, <Voreinstellung>, <Anzahl>, <Trennzeichen>,
<Überschrift>, <Höhe in Zeilen>, <Breite in Spalten>, <Elementhöhe
in Pixel>, <Expandierstufe> [,<Editieren>
[,<Rot>, <Grün>,
<Blau>]])
|
||||||||||||||||||||||||||||||||
|
|
|
||||||||||||||||||||||||||||||||
|
Bedeutung: |
Erzeugt
einen Treeview, der in einem eigenen Window angezeigt wird. WINDOWPOS legt die Position des
TREEVIEW-Windows fest. Der
TREEVIEW wird wie ein Maskenfeld auf der aktuellen Maske eingefügt, wenn
folgende 2 Bedingungen erfüllt sind: 1.
Der Parameter NOWAIT ist angegeben. 2.
Die Variable EBUS_CHILDWINDOW ist
ungleich 0. In
diesem Fall kann der TREEVIEW wie die anderen Felder der Maske mit den Tasten
<→|>, <↓>, etc. angesprungen
werden. Im <Exit-Makro> enthält die Variable EBUS_DATA den Returncode des TREEVIEW. Bei
NOWAIT wird der TREEVIEW gestartet und die Funktion kehrt sofort zurück und
liefert die Identifizierungsnummer (Handle) des TREEVIEW. Mit der Anweisung CLOSE_TREEVIEW(<Handle>) kann ein
mit NOWAIT geöffneter TREEVIEW geschlossen werden. Bei
WAIT wird TREEVIEW hierarchisch gestartet: Die Funktion kehrt erst zurück,
wenn der TREEVIEW beendet wurde. Der
Makro <Exit-Makro> wird ausgeführt, nachdem der TREEVIEW beendet wurde. Wird
WAIT oder NOWAIT angegeben, so muss auch ein <Exit-Makro> angegeben
werden. Bei NOWAIT enthält im <Exit-Makro> die Variable EBUS_DATA den
Returncode des TREEVIEW. Wenn
der TREEVIEW im Splitwindow angezeigt werden soll, muss
<Split-Windowcall-Handle> die Identifizierungsnummer des Splitwindows
enthalten. Wenn
der TREEVIEW als Maskenfeld auf einer WINDOWCALL-Maske angezeigt werden soll,
muss EBUS_CHILDWINDOW <> 0 sein
und <Split-Windowcall-Handle> muss die Identifizierungsnummer der WINDOWCALL-Maske enthalten. Fehlen
die Parameter [WAIT | NOWAIT,<Exit-Makro>,<Split-Windowcall-Handle>],
so ist dies gleichbedeutend mit WAIT. Alle
ON <Ereignis> Makros werden bei NOWAIT beim
Start des TREEVIEW und bei jedem Verlassen des TREEVIEW gesichert. Beim erneuten
Aktivieren des TREEVIEW wird der letzte Zustand der Schalter und ON
<Ereignis> Makros wieder hergestellt. Nach jedem ON
<Ereignis> Macro, der im TREEVIEW ausgeführt wird, werden die ON
<Ereignis> Makros erneut gesichert. <Array>
ist der Name der Variablen eines eindimensionalen String-Arrays. Es ist nur
der Name der Variablen ohne Indizes anzugeben. Die Elemente von <array>
legen den Aufbau des Baumes von oben (der Wurzel) nach unten fest und müssen folgendermaßen
aufgebaut sein: <Stufe><Trennzeichen><Bildname><Trennzeichen><Text> <Stufe>
ist eine Zahl, die die Verschachtelungstiefe im Baum festlegt. Das erste
Element von <Array> (das ist das Element Nr. 1, das Element Nr. 0 wird
nicht berücksichtigt) bezeichnet die Wurzel und hat deshalb als <Stufe>
den Wert 0. Alle nachfolgenden Elemente müssen eine <Stufe> > 0
besitzen. <Bildname>
bezeichnet ein Bild, das im Baum angezeigt werden soll. Die im Baum
verwendeten Bilder sollten zusätzlich mit #ADD_IMAGE
dem Programm bekannt gemacht werden, damit sie in die jar-Datei eingetragen
werden können. <Text>
ist der Text, der im Baum neben dem Bild angezeigt wird. <Voreinstellung>
legt fest, welches Element des Baumes beim Start von TREEVIEW selektiert
wird. Der Baum wird dabei automatisch soweit expandiert, dass das gewünschte
Element sichtbar wird. Als <Voreinstellung> kann der <Text> des
Elementes oder der vollständige Pfad des Elementes angegeben werden. Der Pfad
besteht aus den durch <Trennzeichen> getrennten Texten ausgehend von
Stufe 0 bis zur Stufe des markiert anzuzeigenden Elementes (siehe Beispiel).
Wird nur der <Text> angegeben und kommt dieser <Text> im Baum
mehrfach vor, so wird das erste gefundene Element selektiert. Ist
<Voreinstellung> der Leerstring "", so wird das Wurzelelement
selektiert. <Anzahl>
ist die Anzahl der Elemente, die von SELECTA verwendet werden. Das erste
Element in der Tabelle ist das Element Nr. 1. Das Element Nr. 0 wird von
TREEVIEW nicht verwendet. Es ist sicherzustellen, dass ein korrekter Wert
übergeben wird. Es wird nicht geprüft, ob <Anzahl> größer als die
Dimensionierung der Variablen ist. Ist dies der Fall, so werden
Laufzeitfehler gemeldet. <Trennzeichen>
legt fest, durch welches Zeichen <Stufe>, <Bildname> und
<Text> getrennt werden. Ist <Trennzeichen> der Leerstring, so
gilt der Strichpunkt ";" als Trennzeichen. <Überschrift>
legt die Windowüberschrift fest. <Höhe
in Zeilen> und <Breite in Spalten> legen die Größe des TREEVIEW in
Zeilen und Spalten fest. <Elementhöhe
in Pixel> legt die Höhe der TREEVIEW-Elemente fest. Ist <Elementhöhe in
Pixel> <= 0, so wird die optimale Höhe aus der Größe der Bilder und der
Größe der Schrift berechnet. <Expandierstufe>
legt fest, bis zu welcher Stufe der Baum beim Start expandiert wird. Ist
<Editieren> <> 0, so können die Elemente des Baumes nach
zweimaligem Klick (Achtung: Kein Doppelklick !) editiert werden. Über
die Funktion TREEVIEW_EDIT_TEXT können
Elemente editiert werden, auch wenn <Editieren> = 0 ist. Durch
<Rot>, <Grün> und <Blau> wird die Hintergrundfarbe des
TREEVIEW festgelegt. Ist einer dieser Parameter < 0, so wird die
Standardhintergrundfarbe verwendet. Alle
ON SELECT(<Taste>) Makros sind im TREEVIEW
wirksam. Bei der Ausführung dieser Makros enthält EBUS_TREEVIEW$ den Pfad und EBUS_TREEVIEW die Nummer
des aktuell markierten Elementes. TREEVIEW
liefert folgende Ergebniswerte:
|
||||||||||||||||||||||||||||||||
|
Parameter: |
|
||||||||||||||||||||||||||||||||
|
Beispiel: |
DIM T$(20) T$(1) = "0;ansprech.png;Ansprechpartner" T$(2) = "1;firma.png;Fritsch GmbH" T$(3) = "2;person.png;Huber Franz" T$(4) = "2;person.png;Meier Josef" T$(5) = "1;firma.png;Karo Verlag" T$(6) = "2;person.png;Hübner Jutta" T$(7) = "2;person.png;Bauer Sigrid" T$(8) = "2;person.png;Talhammer Bernd" T$(9) = "2;person.png;Arndt Erich" /* VOREINST$ enthält den vollständigen Pfad VOREINST$ = "Ansprechpartner;Karo
Verlag;Arndt Erich" WINDOWPOS(0,0) H% = TREEVIEW(T$,VOREINST$,9,";","Firmen-Ansprechpartner",15,50,16,0) IF H% = -1 THEN … Fehler … ENDIF |
||||||||||||||||||||||||||||||||
|
Siehe auch: |
|