Object PmgWEdit (EditBox)
Description:
The object serves for entering or displaying a value as the PmgString object. Contrary to the PmgString object it allows to enter the value by editing on place (the object switches, for example, after pressing the mouse, into the edit mode when it has cursor). Editing on place allows in addition, for example, the PmgWTable object. The object value is stored in the Value property. Its possible data binding specifies the source (and destination) where the value is written in the time of entering a new value, see the onDataEditAccept event. The data binding is here "for read and write", it means that if the source of the data binding is changed by other methods, then the change of this source is reflected into the change of this object, i.e. the object displays the changes of this referred variable (if the object is not switched into edit mode).
The object is not limited to the text size, i.e. the text of large size can be shown there (it has sense only if the "Multiline text" configurator is checked).
This object is the Window Pmg object.
This object adopts properties and methods of the PmgObject object.
Properties and methods:
| ColorItem | Background color |
|---|---|
| ColorText | Color of the text value |
| Value | Displayed value |
Events:
| onDataEditAccept | Is triggered after final change of the object content |
|---|---|
| onDataEditCancel | Is triggered after pressing the Esc key |
| onDataEditing | Is triggered on changing the object content |
| onFocusIn | Is triggered if the object receives focus |
| onFocusOut | Is triggered if the object loses focus |
| onModeChange | Is triggered when the Pmg object mode changes |
| onMousePress | Is triggered after pressing or releasing the left mouse button |
| onRefresh | Is triggered on the data refresh of the Pmg object |
| onStart | Is triggered on the construction of the Pmg object in the course of opening the panel |
| onStop | Is triggered on the destruction of the Pmg object in the course of closing the panel |
Configuration tabs:
| Object | General information about the object |
|---|---|
| Content | Content of the Pmg object in the XML form |
| Position | Setting the position, width and height of the Pmg object |
| Variables | List and configuration of user defined Pmg object variables |
| Events | Algorithms definition for the object events |
| Methods | Definition of designer's method of the Pmg object |
| Edit | Properties of the PmgWEdit object |
| Attributes | Attributes of the PmgWEdit object |
History:
Pm8.03.23: Fixed bug: Editing in multirow mode.
Pm8.03.16: Fixed bug: While entering value byEnter key the onDataEditAccept event was not triggered.
Pm8.03.10: Fixed bug: Is now functional also for German localization setting of the OS Windows (where the number contains separator of thousands "period").
Pm8.01.05: in the Web panel the "Value format type" configurator sometimes did not work if set to formatting rule of %f or %e.
Pm8.01.01: The Value property used to be of the String type, but now (according to the "Data type of entered value" configurator) returns the value of String, Integer or Float type. The old behavior can be activated in the "Always return String (obsolete)" configurator (the objects that are already existing will use the old setting so the behavior remains the same as before).
PROMOTIC 9.0.14 SCADA system documentation - MICROSYS, spol. s r.o.
Send page remarkContact responsible person
Send page remarkContact responsible person