initget


(initget  [ bitflags ]  [ keywords ] )

This function defines available keywords for the next user input.

Arguments

bitflags  (optional) combination of bit values to control the behaviour;

bit 0 = 1 : if set, does not allow empty input
bit 1 = 2 : if set, does not allow 0 value as input
bit 2 = 4 : if set, does not allow negative value as input
bit 3 = 8 : if set, point outside drawing limits is accepted (ignores LIMCHECK setting)
bit 5 = 32 : if set, uses the rubberband line at mouse cursor
bit 6 = 64 : if set, only 2D point is returned (Z coordinate is ignored)
bit 7 = 128 : if set, allows arbitrary input (bit 0 is ignored then, empty input returns an empty string)
bit 8 = 256 : if set, distance input takes priority over arbitrary input
bit 9 = 512 : if set, (getpoint) and (getcorner) will use a temporary dynamic UCS, when the mouse hovers an entity
bit 10 = 1024 : if set, the ORTHO, POLAR, Z-SNAPPING, and tracking is disabled/ignored

keywords  (optional) a keyword string in format "Length Width ..." or "Length Width _ Length Width";
keywords before "_" underscore delimiter are treated as localised keywords, keywords behind are treated as English keywords, and user can enter the English keywords with preceding underscore then;
if English keywords are specified, user input string/keyword is translated to the English keywords
(English has priority over localised keywords)

Return

always NIL

Example

(initget  "Alle Keine _ All None")
user input "A" will return "All"
user input "_None" will return "None"

Remarks

(initget) is respected by (entsel) (getangle) (getcorner) (getdist) (getint) (getkword) (getorient) (getpoint) (getreal) (getstring)
(nentsel) (nentselp) functions;
(initget) affects only the next user input function !



©  Bricsys NV. All rights reserved.