The string argument is interpreted according to the following rules: User-input functions and applicable control bits (continued) If the user input fails one or more of the specified conditions (as in a zero value when zero values are not allowed), AutoCAD displays a message and asks the user to try again. If initget sets a control bit and the application calls a user-input function for which the bit has no meaning, the bit is ignored. The initget bit values and keywords apply only to the next user-input function call.
If the user input is not an expected type and does not match a keyword, AutoCAD asks the user to try again. The application can test for the keywords and perform the action associated with each one. If the user input matches a keyword from the list, the function returns that keyword as a string result. The keywords are checked by the next user-input function call when the user does not enter the expected type of input (for example, a point to getpoint). The getstring function is the only user-input function that does not honor keywords. The functions that honor keywords are getint, getreal, getdist, getangle, getorient, getpoint, getcorner, getkword, entsel, nentsel, and nentselp. In 2D-only commands it can be confusing and error-prone to allow 3D points to be entered using ortho Z, polar Z, or otrack Z. This is useful when you create 2D entities such as a polyline, arc, or circle, or when you use the AutoCAD ARRAY command, which creates only a 2D array. Setting this bit before calls to any of these functions will temporarily disable ortho, polar, and otracking in the Z direction. This functionality is not enabled for non-planar faces such as the side of a cylinder.ġ024 (bit 10) - When calling getdist, getangle, getorient, getpoint, or getcorner, you may not want the distance, angle, orient, point, or corner to be influenced by ortho, polar, or otracking in the Z direction. After the point is acquired, the dynamic UCS is reset to the current UCS. It is dynamically re-established when the cursor moves over a different face. The temporary UCS is reset when the cursor moves off of a face. Note that legal point input from the keyboard always takes precedence over either direct distance or arbitrary input.ĥ12 (bit 9) - If set before a call to getpoint or getcorner, a temporary UCS will be established when the cursor crosses over the edge of a planar face of a solid. Set this bit if you wish to force AutoCAD to evaluate user input as direct distance input. For external applications, arbitrary input is given precedence over direct distance input by default. This bit takes precedence over bit 0 if bits 7 and 0 are set and the user presses Enter, a null string is returned.Ģ56 (bit 8) - Give direct distance input precedence over arbitrary input.
(Some display drivers use a distinctive color instead of dashed lines.) If the AutoCAD POPUPS system variable is 0, AutoCAD ignores this bit.Ħ4 (bit 6) - Prohibits input of a Z coordinate to the getdist function lets an application ensure that this function returns a 2D distance.ġ28 (bit 7) - Allows arbitrary input as if it is a keyword, first honoring any other control bits and listed keywords. For those functions with which the user can specify a point by selecting a location in the drawing area, this bit value causes the rubber-band line or box to be dashed instead of solid. This condition applies to the next user-input function even if the AutoCAD LIMCHECK system variable is currently set.ģ2 (bit 5) - Uses dashed lines when drawing a rubber-band line or box. The bit values are as follows:ġ (bit 0) - Prevents the user from responding to the request by entering only Enter.Ģ (bit 1) - Prevents the user from responding to the request by entering zero.Ĥ (bit 2) - Prevents the user from responding to the request by entering a negative value.Ĩ (bit 3) - Allows the user to enter a point outside the current drawing limits. If no bits argument is supplied, zero (no conditions) is assumed.
The bits can be added together in any combination to form a value between 0 and 255. A bit-coded that allows or disallows certain types of user input.