boolean SetDefaultInputMode(long nInputMode);
Function SetDefaultInputMode(nInputMode As Long) As Boolean
Set the default input mode for RFInput.
In the RFInput() function, the nInputMode parameter is "ORed" (logical
OR) with this value.
Parameters
nInputMode
One or more (adding) of the following
constants :
| Constant | Description Default behavior |
|---|---|
Automatic return |
|
| WLNO_RETURN_FILL | Do not return from function if the
maximum length is reached. Needs the ENTER key to be
pressed. (If not set) Automatic return if the maximum length is reached, without ENTER key by default. |
| WLNO_RETURN_BKSP | Do not return from function if the BKSP
key is pressed and the input area is empty. (If not set) Return if the BKSP key is pressed, in an empty input area by default. |
Backlight |
|
| WLBACKLIGHT | Switch on (timed-out) the display backlight. |
Display |
|
| WLECHO_ASTERISK | Replace the displayed characters with an asterisk (*). |
| WLSUPRESS_ECHO | Do not display the input data. (If not set) Display by default. |
Input characters |
|
| WLALPHA_ONLY | Allow only alphabetic characters in
input. (If not set) All characters are allowed by default. |
| WLNUMERIC_ONLY | Allow only numeric characters in input. (If not set) All characters are allowed by default. |
| WLINCLUDE_DATA | When a function key is pressed, returns
the data and function key. (If not set) When a function key is pressed, returns only the function key and data is discarded by default. |
| WLTOUPPER | Uppercase keyed data characters. (If not set) The input characters are not modified. |
Input devices |
|
| WLDISABLE_SCAN | Disable the barcode scanner for input. (If not set) Enabled by default. |
| WLDISABLE_KEY | Disable the keyboard for input (but not
the function keys). (If not set) Enabled by default. |
| WLDISABLE_FKEYS | Disable the function keys for input. (If not set) Enabled by default. |
| WLSOFT_TRIGGER | Activate the scanner (timed-out) at
input time. (If not set) Scanner is activated by trigger keys by default |
Length control |
|
| WLFORCE_ENTRY | Do not return from function with an
empty input. (If not set) Return if ENTER key is pressed with an empty input by default. |
| WLMAXLENGTH | The function doesn't allow more characters than the
maximum defined by nLength. (If not set) The function allows input for more characters than defined by nLength (system limitations). |
| WLNOCRIFEMPTY | Do not put a CR (013, 0x0Dh) when an empty string is
input. (If not set) Put a CR (013, 0x0Dh) when an empty string is input. |
Edit Mode |
|
| WLEDIT_DEFAULT | If default data is supplied, the input data is
appended. (If not set) The default data is overwritten, new input replaces default. |
Timeout |
|
| WLINPUTTIMEOUT | Sets a timeout for user input. Uses KeyTime from
RFTERMINAL for timeout timeframe and returns a WLCOMMANDTYPE "TIMEOUT"
message if the user goes over the timeout. (If not set) No Timeout. |
Unsupported |
|
| WLNO_NONPRINTABLE | Suppress the display of some characters. (If not set) All character set is displayed. |
| WLCLR_INPUT_BUFFER | Clear the input buffer before input. |
| WLINGORE_CRLF | Include CR and LF in scanner input if
present in the barcode. Always do that. |
Example
Public wsRfIo As New RFIO
Public Sub Main()
wsRfIo.SetDefaultInputMode WLNOCRIFEMPTY + WLTOUPPER
End Sub
See also RFIO, RFInput, RFTERMINAL.