Promotic

Object PmgWCombo (ComboBox)

Description:
The object serves for entering value by the selection from the list of pre-defined values. The selected value can be either an index, visible text or invisible value - see the "The selected value is" configurator. The list can be displayed in the running application by the Alt+Down keys, texts can be selected by the Down/Up keys.
The selected option is stored in the SelectedIndex, SelectedText and SelectedValue properties. If the selected value has a data binding, then the value is written into the variable referred to by a data binding on changing the ComboBox value respectively in the time that is set on the "Attributes" tab (on the Enter key, on the selection from the menu, etc.). The data binding is here "for read and write", it means that if the variable of the data binding is changed even by other methods, then the change of this variable is reflected into the change of the ComboBox value.
This object is the Window Pmg object.
This object inherits properties, methods and events of the PmgObject object.
Properties and methods of this object:
AddOptionAdds an option into the list
ColorItemBackground color
ColorTextText color
OptionsReading visible texts, hidden values or whole options from the list by the index
OptionsCountThe number of options in the list
RemoveOptionsClearing the list
SelectedIndexIndex of the selected text (zero-based index).
SelectedTextSelected visible text
SelectedValueHidden value associated with selected visible text
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 on ending the value selection
onDataEditCancelIs triggered after pressing the Esc key
onDataEditingIs triggered on changing the selected value
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
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
ComboProperties of the PmgWCombo object
AttributesAttributes of the PmgWCombo object

History:
Pm9.00.00: Object name changed: PmiWCombo -> PmgWCombo
Pm8.02.13: the object size did not adapt to font size in the runtime mode.
PROMOTIC 9.0.18 SCADA system documentation - MICROSYS, spol. s r.o.

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