ShowInplaceInput

The function ShowInplaceInput shows a simple text input dialog at a specified location in the project client/viewer.

Function Group Execution Windows Embedded Thin Client Mobile Access
ShowInplaceInput Screen Asynchronous Supported Supported Supported Not supported

Syntax

  ShowInplaceInput("tagOutput",numStartXPos,numStartYPos,optNumMin,optNumMax,optNumEnablePasswordMode,optNumShowOSVK)  
Web Studio Help ons screen showinplaceinput.xml d416864e139 ShowInplaceInput

tagOutput
The name of a tag that will receive the input.
Note: The tag name should be enclosed in quotes, as shown in the syntax diagram, or else the function will try to use the value of the tag.
numStartXPos
The starting X position of the top-left corner of the input dialog — that is, the number of pixels between that corner and the left side of the display.
numStartYPos
The starting Y position of the top-left corner of the input dialog — that is, the number of pixels between that corner and the top of the display.
optNumMin
The minimum numeric value that will be accepted by the input dialog.

This is an optional parameter. If no value is specified, then the dialog will accept any value.

optNumMax
The maximum numeric value that will be accepted by the input dialog.

This is an optional parameter. If no value is specified, then the dialog will accept any value.

optNumEnablePasswordMode
An option to enable password mode, which obfuscates the operator’s input as if it’s a password:
Value Description
0 Show input as plain text.
1 Obfuscate input.

This is an optional parameter. If no value is specified, then the default is 0.

optNumShowOSVK
An option to show the default Virtual Keyboard, which is configured in the project settings:
Value Description
0 Do not show Virtual Keyboard.
1 Show Virtual Keyboard.

This is an optional parameter. If no value is specified, then the default is 0.

Returned value

This function returns the following possible values:
Value Description
0 Success.
-1 Invalid tag specified for tagOutput.
-2 Invalid number of parameters.
-3 Viewer is not running.

Notes

If the option Enforce Web functionality equivalence is selected in the project settings, this function cannot be called from Global Procedures or Script worksheets. This is because the function is meaningful only when it is executed on stations that display project screens; it might cause unexpected behavior if it is called from background tasks that are executed on the project runtime server. For more information, see Preferences tab.

Examples

  ShowInplaceInput("OperatorInput",50,50)  
  ShowInplaceInput("OperatorInput",50,50,1,100)  
  ShowInplaceInput("OperatorInput",50,50,1,100,0,1)  

ShowInplaceInput