Promotic
WikipediaLinkedInYoutubeTwitterFacebook

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:
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 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
© MICROSYS, spol. s r. o.Tavičská 845/21 703 00 Ostrava-Vítkovice