Update Property
Applies To
TextBox
Description
Gets or sets if the value of textbox is updated automatically or not when it is set to display the global variable.
Usage
GGet Form.Control.Update, var
GSet Form.Control.Update, value
- Form
- Name of a form or string variable containing a form name.
- Control
- Name of a control or string variable containing a control name.
- var
- Boolean variable that will contain the value of the property.
- value
- Boolean expression for the new value of the property.
Values
False
True
Default: True
Remarks
To show a SPEL+ global variable (except arrays) on a textbox, set the global variable name in the Variable property. If the Update property is set to False, the global variable value is not updated.
When you set the TextBox Variable property to a global variable, by default RC+ automatically updates the TextBox Text value with the value of the variable at runtime. The Update property default value is True. If you want to allow a user to change the value of the same variable, you must set Update to False. This stops the auto update so the user can type in a new value.
When Update is set from False to True, RC+ sets the value of the variable to the new value entered by the user in the TextBox. One method is to add a CheckBox above the TextBox called “Change Value” or some similar name. In the ChechkBox Click event, use GGet to get the checked state of the CheckBox and then use GSset to set the TextBox Update property. When the box is checked, set Update to False.
See Also
TextBox, Variable
Example
GSet frmMain.txtStatus.Update, False