Appearance

TLB_EXPAND ​

This command expands or collapses an entry with the given ID.

Syntax ​

leo-grammar
CC "AdoScript" TLB_EXPAND id:intValue [parentid:intValue ] [expand:boolValue ]

# --> RESULT ecode:intValue
CC "AdoScript" TLB_EXPAND id:intValue [parentid:intValue ] [expand:boolValue ]

# --> RESULT ecode:intValue

Parameters ​

  • id (intValue) - specifies the unique ID of the entry to be expanded.
  • parentid (intValue, optional) - specifies the ID of the parent entry of the entry to be expanded. This may be helpful if some child entries do not have unique IDs.
  • expand (boolValue, optional) - pecifies whether the entry should be expanded (value = 1) or collapsed (value = 0)

Returns ​

  • ecode (intValue) - as follows 0 = no error occured, 1 = user canceled dialog, 2 = you have to call TLB_CREATE before calling this function, 3 = an argument is missing, 4 = you passed an invalid ID

Details ​

The parent entry of the entry to be expanded must also be expanded, otherwise this command wont work!

To expand all levels up to a certain entry, use TLB_EXPAND_TO.

See Also ​

TLB_ADD_BUTTON
TLB_CREATE
TLB_EXPAND_ALL
TLB_EXPAND_TO
TLB_INSERT
TLB_REMOVE
TLB_SELECT
TLB_SELECT_ALL
TLB_SHOW

Examples ​

asc
# create the main TreeListBox with all its parameters
CC "AdoScript" TLB_CREATE title:"My title" oktext:"Close" canceltext:"No way!"
        boxtext:"These are my entries" no-help:1 button-w:60
        max-w:500 max-h:367 min-w:200 min-h:150 checklistbox:0

# insert some entries (as you like - ID should be unique)
CC "AdoScript" TLB_INSERT id:1 text:"Do this" is-parent:1
CC "AdoScript" TLB_INSERT id:2 text:"Do that" 
CC "AdoScript" TLB_INSERT id:3 parentid:1 text:"here"  
CC "AdoScript" TLB_INSERT id:4 parentid:3 text:"Now I am here"


CC "AdoScript" TLB_EXPAND id:2 expand:1

# and finally show it
CC "AdoScript" TLB_SHOW
IF (ecode = 0) {
    CC "AdoScript" INFOBOX ("Selected ids: " + selectedids + "\n" +
                            "You pushed the following button: " + endbutton)
} ELSE {
    CC "AdoScript" INFOBOX ("You cancelled the dialog!")
}
# create the main TreeListBox with all its parameters
CC "AdoScript" TLB_CREATE title:"My title" oktext:"Close" canceltext:"No way!"
        boxtext:"These are my entries" no-help:1 button-w:60
        max-w:500 max-h:367 min-w:200 min-h:150 checklistbox:0

# insert some entries (as you like - ID should be unique)
CC "AdoScript" TLB_INSERT id:1 text:"Do this" is-parent:1
CC "AdoScript" TLB_INSERT id:2 text:"Do that" 
CC "AdoScript" TLB_INSERT id:3 parentid:1 text:"here"  
CC "AdoScript" TLB_INSERT id:4 parentid:3 text:"Now I am here"


CC "AdoScript" TLB_EXPAND id:2 expand:1

# and finally show it
CC "AdoScript" TLB_SHOW
IF (ecode = 0) {
    CC "AdoScript" INFOBOX ("Selected ids: " + selectedids + "\n" +
                            "You pushed the following button: " + endbutton)
} ELSE {
    CC "AdoScript" INFOBOX ("You cancelled the dialog!")
}

Versions and Changes ​

Available since ADOxx 1.3