Promotic

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:
ColorItemBackground color
ColorTextColor of the text value
ValueDisplayed value
Properties and methods inherited from the PmgObject object:
AddEventRegisters a function into selected event
BlinkStarts/stops blinking of the Pmg object
DxWidth of the Pmg object
DyHeight of the Pmg object
EnabledEnable/disable the control, i.e. user's inputs to the object
FocusDetects/set the focus of the Pmg object
GetChildByIndexReturns the nested Pmg object defined by order
GetChildCountReturns the number of nested Pmg objects
GetPathNameObject name with the path to this object
GetItemInfoReturns special information regarding the Pmg object
GetParReading the value of the Pmg object parameter (or its parents)
IniDxInitial width of the Pmg object
IniDyInitial height of the Pmg object
IniXInitial X-position of the left upper corner of the Pmg object relative to superior object
IniYInitial Y-position of the left upper corner of the Pmg object relative to superior object
ItemsReturns reference to Pmg object
MethodsAccess to designer's methods of this object
MouseOnIdentification if the mouse cursor finds itself over the Pmg object
NameThe name of the Pmg object
ParentReturns reference to the parent Pmg object
PmReturns the Pma object (obsolete)
PmPanelReturns reference to the PmaPanel object where the Pmg object is placed
RefreshRefresh of the Pmg object
RemoveEventDeregisters the function in the specified event
RootReturns reference to the root PmgRoot object
ShowMenuOpens local menu of the Pmg object
ScreenXX-coordinate of the left upper corner of the Pmg object relative to computer screen
ScreenYY-coordinate of the left upper corner of the Pmg object relative to computer screen
ToolTipTooltip text of the Pmg object
VarsReturns the variable of the Pmg object
ViewXPosition of X-coordinate of the left upper corner of the Pmg object relative to the PmgRoot object
ViewYPosition of the Y-coordinate of the left upper corner of the Pmg object relative to the PmgRoot object
VisibleSets the visibility/invisibility of the Pmg object
XX-coordinate of the left upper corner of the Pmg object relative to superior Pmg object
YY-coordinate of the left upper corner of the Pmg object relative to superior Pmg object
Events of this object:
onDataEditAcceptIs triggered after final change of the object content
onDataEditCancelIs triggered after pressing the Esc key
onDataEditingIs triggered on changing the object content
Events inherited from the PmgObject object:
onStartIs triggered on the construction of the Pmg object in the course of opening the panel
onStopIs triggered on the destruction of the Pmg object in the course of closing the panel
onRefreshIs triggered on the data refresh of the Pmg object
onMousePressIs triggered after pressing or releasing the left mouse button
onModeChangeIs triggered when the Pmg object mode changes
onFocusInIs triggered if the object receives focus
onFocusOutIs triggered if the object loses focus
Configuration tabs:
ObjectGeneral information about the object
PositionSetting the position, width and height of the Pmg object
VariablesList and configuration of user defined Pmg object variables
EventsAlgorithms definition for the object events
MethodsDefinition of designer's method of the Pmg object
EditProperties of the PmgWEdit object
AttributesAttributes of the PmgWEdit object

History:
Pm9.00.00: Object name changed: PmiWEdit -> PmgWEdit
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 Windows OS (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.21 SCADA system documentation - MICROSYS, spol. s r.o.

Send page remarkContact responsible person
© MICROSYS, spol. s r. o.