VisuDlg_ProcessChar (FUN)

FUNCTION VisuDlg_ProcessChar

This function takes a given character and appends/inserts it in the string representing the variable value. To decide, which action has to be performed, the current caret position and the currently selected text is evaluated.

InOut:

Scope

Name

Type

Comment

Inout

stOutputValue

STRING

This is the string representation of the variable value, that will be displayed in the visualization. If the flag xPassword is TRUE the variable value will be display with password characters

stVariableValue

STRING

This parameter is the variable value, where the character is appended/inserted

iCaretPosition

INT

The current position of the caret. Either within the text or at the end of the text

iSelectionStart

INT

The start of the selected text (1-relative)

iSelectionEnd

INT

The end of the selected text (1-relative). If the complete text is selected this parameter is textlength + 1

Input

xPassword

BOOL

Inidicates, whether the entered value should be readable (FALSE) or displayed with password characters

cToConsume

STRING(4)

The character to append/insert