Appearance

TLB_SELECT ​

This command can be used to manually select an entry in the TreeListBox.

Syntax ​

leo-grammar
CC "AdoScript" TLB_SELECT id:intValue [ parentid:intValue ] [ select:boolValue ]

# --> RESULT ecode:intValue
CC "AdoScript" TLB_SELECT id:intValue [ parentid:intValue ] [ select:boolValue ]

# --> RESULT ecode:intValue

Parameters ​

  • id (intValue) - specifies the unique ID of the entry to be selected.
  • parentid (intValue, optional) - specifies the ID of the parent of the entry to be selected. This may be helpful if some child entries do not have unique IDs.
  • select (boolValue, optional) - specifies whether the entry should be selected (value = 1) or deselected (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 ​

See Also ​

TLB_ADD_BUTTON
TLB_CREATE
TLB_EXPAND
TLB_EXPAND_ALL
TLB_EXPAND_TO
TLB_INSERT
TLB_REMOVE
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:1

# insert some entries (as you like - ID should be unique)
CC "AdoScript" TLB_INSERT id:1 text:"Do this"
CC "AdoScript" TLB_INSERT id:2 text:"Do that"

# select the first entry (here: check it)
CC "AdoScript" TLB_SELECT id:1 select: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:1

# insert some entries (as you like - ID should be unique)
CC "AdoScript" TLB_INSERT id:1 text:"Do this"
CC "AdoScript" TLB_INSERT id:2 text:"Do that"

# select the first entry (here: check it)
CC "AdoScript" TLB_SELECT id:1 select: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