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 is meaningful only if the "Multiline text" configurator is checked).
This object is the Window Pmg object.
This object inherits properties, methods and events of the PmgObject object.
Properties and methods of this object:
| ColorItem | Background color |
|---|---|
| ColorText | Color of the text value |
| Value | Displayed value |
Properties and methods inherited from the PmgObject:
| AddEvent | Registers a function into selected event |
|---|---|
| Blink | Starts/stops blinking of the Pmg object |
| Dx | Width of the Pmg object |
| Dy | Height of the Pmg object |
| Enabled | Enable/disable the control, i.e. user's inputs to the object |
| Focus | Detects/set the focus of the Pmg object |
| GetChildByIndex | Returns the nested Pmg object defined by order |
| GetChildCount | Returns the number of nested Pmg objects |
| GetPathName | Name of the Pmg object including the path that consists of parent Pmg objects names |
| GetItemInfo | Returns special information regarding the Pmg object |
| GetPar | Reading the value of the Pmg object parameter (or its parents) |
| IniDx | Initial width of the Pmg object |
| IniDy | Initial height of the Pmg object |
| IniX | Initial X-position of the upper-left corner of the Pmg object relative to superior object |
| IniY | Initial Y-position of the upper-left corner of the Pmg object relative to superior object |
| Items | Returns reference to Pmg object |
| Methods | Access to designer's methods of this object |
| MouseOn | Identification if the mouse cursor finds itself over the Pmg object |
| Name | The name of the Pmg object |
| Parent | Returns reference to the parent Pmg object |
| Pm | Returns the Pma object or to its subobject (obsolete) |
| PmPanel | Returns reference to the PmaPanel object where the Pmg object is placed |
| Refresh | Refresh of the Pmg object |
| RemoveEvent | Deregisters the function in the specified event |
| Root | Returns reference to the root PmgRoot object |
| ShowMenu | Opens local menu of the Pmg object |
| ScreenX | X-coordinate of the upper-left corner of the Pmg object relative to computer screen |
| ScreenY | Y-coordinate of the upper-left corner of the Pmg object relative to computer screen |
| ToolTip | Tooltip text of the Pmg object |
| Vars | Returns the variable of the Pmg object |
| ViewX | Position of X-coordinate of the upper-left corner of the Pmg object relative to the PmgRoot object |
| ViewY | Position of the Y-coordinate of the upper-left corner of the Pmg object relative to the PmgRoot object |
| Visible | Sets the visibility/invisibility of the Pmg object |
| X | X-coordinate of the upper-left corner of the Pmg object relative to superior Pmg object |
| Y | Y-coordinate of the upper-left corner of the Pmg object relative to superior Pmg object |
Events of this object:
| 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 |
Properties and methods inherited from the PmgObject:
| 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 |
| onRefresh | Is triggered on the data refresh of the Pmg object |
| onMousePress | Is triggered after pressing or releasing the left mouse button |
| onModeChange | Is triggered when the Pmg object mode changes |
| onFocusIn | Is triggered if the object receives focus |
| onFocusOut | Is triggered if the object loses focus |
Configuration tabs:
| Object | General information about the object |
|---|---|
| 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.22: Fixed bug: The setting "Read only" was not working on the Web. Editing was always possible.
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.17 SCADA system documentation - MICROSYS, spol. s r.o.
Send page remarkContact responsible person
Send page remarkContact responsible person