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
Input	`cToConsume`	`STRING(4)`	The character to append/insert