acet-ui-table-name-get


(acet-ui-table-name-get  lstParams)

This function allows to select one or more Table or Dictionary entries, using a dialog or the commandline;
it calls (acet-ui-table-name-get-dlg) or (acet-ui-table-name-get-cmd) internally.
if CMDDIA is set to 0, or if there is any other "outer" command running incl. script file, then the commandline version is used.

lstParams : (list) list of parameters which specify the behaviour of (acet-ui-table-name-get) function

lstParams parameters list : (title  default  tableName|dictionaryName  [ flags  [ filter  [ helpfile  [ helptopic ] ] ] ])


title

(string)  the title of the dialog (if the dialog is used; not used in commandline version)


default

(string)  the default value being selected in the dialog's list


tableName
or
dictionaryName

(string)  the name of the Table (like Layer, Block, Linetype ...), or the name of a root dictionary


flags

(integer) (optionally)  integer bit values controlling the behaviour, default is 0
0  must select existing name
1  allows to specify a new name, not existing yet
2  disable selection of external references (applies to symbol table names only)
4  enable filtering of entries that match the provided filter 
8  disable object selection option (pick button or the "=" option at commandline prompt)
16 - allow "ByLayer" and "ByBlock" entries (if applicable, otherwise ignored)
32  enable selection of multiple entries/objects
64  ignore locked layers (for LAYER table only)
128  ignore frozen layers (for LAYER table only)
256  ignore off layers    (for LAYER table only)


filter

(list) (optionally) 


helpfile

(string) (optionally)  the help file to be used on "Help" button, and F1 key; same as in (help) functions


helptopic

(string) (optionally)  the help topic to be used on "Help" button, and F1 key; same as in (help) functions


see (acet-ui-table-name-get-dlg) and (acet-ui-table-name-get-cmd) functions

©  Bricsys NV. All rights reserved.