<< Inhaltsverzeichnis Suchen >>

GR_TREEVIEW_INSERT

Funktion

Syntax:

GR_TREEVIEW_INSERT(<EINFUEGEN-NACH>,<ELEMENT>)

<EINFUEGEN-NACH>   = <STRING-AUSDRUCK>
<ELEMENT>                    = <STRING-AUSDRUCK>

Bedeutung:

Diese Funktion fügt im GR_TREEVIEW-Baum eine neues <ELEMENT> hinter dem Element <EINFUEGEN-NACH> ein. <EINFUEGEN-NACH> kann den Text oder den vollständigen Pfad des Elementes enthalten, hinter dem eingefügt werden soll. Enthält <EINFUEGEN-NACH> nur den <TEXT> und nicht den vollständigen Pfad, so wird hinter dem ersten gefundenen Element des Baumes eingefügt, wenn der Text im Baum mehrfach vorkommt.

<ELEMENT> muß genauso aufgebaut sein wie bei der Definition in GR_TREEVIEW:

"<STUFE><TRENNZEICHEN><BILD-NAME><TRENNZEICHEN><TEXT>"

Die <STUFE> muß dabei gleich der Stufe des Elementes <EINFUEGEN-NACH> oder um 1 größer als diese Stufe sein.

GR_TREEVIEW_INSERT liefert folgende Ergebniswerte:

0:           Das <ELEMENT> wurde erfolgreich eingefügt
sonst:     Fehlernummer (siehe GR_TREEVIEW)

Diese Funktion ist nur verfügbar unter WINDOWS 32-Bit. Unter MS-DOS, UNIX und WINDOWS 16-Bit liefert sie als Ergebnis stets -1.

Beispiel:

ON SELECT(INS) MACRO TREEVIEW.INSERT
H% = GR_TREEVIEW(...)
...

MACRO TREEVIEW.INSERT:
NEU$ = "2;person.bmp;Bauer Marion"
EINFUEGEN_NACH$ = "Bauer Sigrid"
H% = GR_TREEVIEW_INSERT(EINFUEGEN_NACH$,NEU$)
IF H% <> 0
THEN ERRORMES = "Fehler beim Einfügen im TREEVIEW:"+STR$(H%)
ENDIF

siehe auch:

GR_TREEVIEW, GR_TREEVIEW_CHANGE_BITMAP, GR_TREEVIEW_DELETE, GR_TREEVIEW_INSERT_ITEM