<<

Inhaltsverzeichnis

Suchen

>>

 

TREEVIEW

 

 

Funktion

 

 

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>]])

 

<Exit-Makro>

= <MAKRONAME>

<Split-Windowcall-Handle>

= <NUM-AUSDRUCK>

<Array>

= <STRING-VARIABLE>

<Voreinstellung>

= <STRING-AUSDRUCK>

<Anzahl>

= <NUM-AUSDRUCK>

<Trennzeichen>

= <STRING-AUSDRUCK>

<Überschrift>

= <STRING-AUSDRUCK>

<Höhe in Zeilen>

= <NUM-AUSDRUCK>

<Breite in Spalten>

= <NUM-AUSDRUCK>

<Elementhöhe in Pixel>

= <NUM-AUSDRUCK>

<Expandierstufe>

= <NUM-AUSDRUCK>

<Editieren>

= <NUM-AUSDRUCK>

<Rot>

= <NUM-AUSDRUCK>

<Grün>

= <NUM-AUSDRUCK>

<Blau>

= <NUM-AUSDRUCK>

 

 

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:

 

1

Der Benutzer hat ein Element der Tabelle mit <RETURN> oder durch einen Doppelklick mit der Maus ausgewählt. Die Variablen EBUS_TREEVIEW und EBUS_TREEVIEW$ enthalten das ausgewählte Element.

0

Der Benutzer hat TREEVIEW mit <Esc> verlassen oder der TREEVIEW wurde beendet.

-1

Es ist ein Fehler aufgetreten. Die Variable OK enthält einen der folgenden Fehlercodes:

 

7903  Element nicht gefunden

7906  Kein Treeview in aktuellem Fenster vorhanden

7907  <Stufe> nicht erlaubt

7908  Tabelle ist leer

7909  Erstes Element hat <Stufe> <> 0

7910  Späteres Element hat <Stufe> <= 0

7911  Treeview passt nicht in Array.

7914   Das Wurzel-Element kann nicht gelöscht werden.

7925  Eine Exception ist aufgetreten.

7926  Treeview kann nicht als Maskenfeld erzeugt werden, da das aktuelle Objekt keine Maske ist.

7927  <Split-Windowcall-Handle> ist kein Handle einer WINDOWCALL-Maske.

-2

Fenster nicht gefunden

 

Parameter:

WAIT|NOWAIT

WAIT: Die Funktion kehrt erst zurück, wenn der TREEVIEW beendet wurde.

NOWAIT: Der TREEVIEW wird gestartet und die Funktion kehrt sofort zurück.

Exit-Makro

Name des Exit-Makros

Split-Windowcall-Handle

Identifizierungsnummer eines Splitwindows, in dem der TREEVIEW angezeigt werden soll oder Identifizierungsnummer einer WINDOWCALL-Maske, auf der der TREEVIEW als Maskenfeld eingefügt werden soll.

Array

Name der Variablen eines eindimensionalen String-Arrays

Voreinstellung

Legt das Element fest, das beim Start des TREEVIEW selektiert wird.

Anzahl

Anzahl der zu verwendenden Elemente von <Array>

Trennzeichen

Trennzeichen für die Einträge in <Array>

Überschrift

Legt die Windowüberschrift fest.

Höhe in Zeilen

Legt die Höhe des TREEVIEW-Windows fest.

Breite in Spalten

Legt die Breite des TREEVIEW-Windows fest.

Elementhöhe in Pixel

Legt die Höhe der TREEVIEW-Elemente fest.

Expandierstufe

Legt fest, bis zu welcher Stufe der Baum beim Start expandiert wird.

Editieren

<> 0: Die Elemente des Baumes können editiert werden.

Rot

Farbanteil Rot

Grün

Farbanteil Grün

Blau

Farbanteil Blau

 

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:

CLOSE_TREEVIEW

TREEVIEW_FONT

TREEVIEW_FONTHEIGHT

TREEVIEW_FONTNAME

TREEVIEW_TEXTCOLOR

GET_TREEVIEW

GET_TREEVIEW_SIZE

GET_TREEVIEW_PATH$

TREEVIEW_CHANGE_IMAGE

TREEVIEW_DELETE

TREEVIEW_DELETE_ITEM

TREEVIEW_INSERT

TREEVIEW_INSERT_ITEM

TREEVIEW_HILITE

TREEVIEW_EDIT_TEXT

EBUS_TREEVIEW

EBUS_TREEVIEW_RMOUSE

EBUS_TREEVIEW$

EBUS_CHILDWINDOW

ON TREEVIEW_EDIT MACRO