OBJECT.TellEvent

BSTR TellEvent()

Function TellEvent() As String

Gets a single user input without removing it from the input queue, and without waiting for user input.

Return value
A string that contains the user input. Empty if no user action or an error occurs.

Parameters

Remarks
This function returns either if there is a user input or not.

No user input
  • RFGetLastError = WLNOERROR
  • LastInputType = WLINPUTERROR
  • String = Empty
User input
  • RFGetLastError = WLNOERROR
  • LastInputType =  WLCOMMANDTYPE, WLKEYTYPE or WLSCANTYPE
  • String = Not Empty
Error
  • RFGetLastError <> WLNOERROR
  • LastInputType =  WLINPUTERROR
  • String = Empty

Do a GetEvent or RFInput to get the data and empty the input queue.
Before processing the returned string, check for any error condition and the input type.

Example

See also    RFIO, RFGetLastError, GetEvent, LastInputType, LastBarcodeType, RFInput,