Promotic

Object PmfTable

Description:
This object represents one form item of the type: "Table".
Properties and methods of this object:
BgColorSetting/getting the background color of the table
DeleteColDelete one or multiple columns
DeleteRowDelete one or multiple rows
EnsureVisibleScrolls the table to requested position.
GetAreaReturns reference to a certain table area (to the PmfTableArea object)
GetAreaWidthReturns current area width according to defined arguments
GetColWidthReturns the table column width
GetSelDetects selected rows or cells
HorzAlignHorizontal table text alignment
InitColsInitialization of table column count
InitRowsInitialization of row count of the table
InsertColInserting one or more new columns
InsertRowInserting one or more new rows
SelTypeType of row or cells selection
SetColWidthSets columns width of the table
SetSelThe entered row (or cell) in the table is marked as selected
TextColorSetting/getting the text color of the table
VertAlignVertical alignment of the table text
Related objects:
PmfTableArea(Table area) The object represents table area (data area, header, footer or the left portion)
PmfTableColumn(Column of the table area) The object represents the column in the selected table area
PmfTableRow(Table area row) The object represents a row in selected table area
PmfTableCell(Table area cell) The object represents a cell in selected table area
Properties and methods that are common to all objects of the PmfObject type:
AddEventRegisters a function into selected event
BodyHeightIniInitial height of the Body area
BodyHeightModeThe way of changing the Body area height
BodyWidthIniInitial width of the Body area
BodyWidthModeThe way of changing the Body area width
EnabledEnable/disable editing of values
IdPmf object identifier
PrivateDataPrivate value of the object
RemoveEventDeregisters the function in the specified event
TitleDisplayed name of the Pmf object
TitlePosPosition of the Title area of the Pmf object
TypePmf object type
VisibleReturns or sets the visibility/invisibility of Pmf object
Events:
onActionIs triggered when an important logical action happens over the object
onFocusIs triggered if the Pmf object gets or loses focus
onSelChangeIs triggered when another row or cell is selected
Note:
- The object can be created by method PmForm.CreateItem("table", ...).
- This object is functional also in Web panels.


Areas in the table:
The table consists of 6 areas:
11 = MainBody = Main data area: The area is always visible.
12 = MainHead = Main area header: The area is visible only if number of rows in this area is non-zero.
13 = MainFoot = Main area footer: The area is visible only if number of rows in this area is non-zero.
21 = LeftBody = Left data area: The area is visible only if number of columns in this are is non-zero.
22 = LeftHead = Left area header: The area is visible only if the LeftBody and MainHead areas are visible.
23 = LeftFoot = Left area footer: The area is visible only if the LeftBody and MainFoot areas are visible.


In table initialization phase, the number of columns and the number of rows is set by methods InitCols and InitRows.
The number of columns and number of rows can be then modified dynamically by methods InsertCol, DeleteCol, InsertRow, DeleteRow.

Access to corresponding area is available by the GetArea method.
Set the value of the cell in corresponding area: oPmfTable.GetArea(11).GetRow(1).GetCell(2).Value = 3.14

History:
Pm9.00.04: Created
PROMOTIC 9.0.23 SCADA system documentation MICROSYS, spol. s r.o.

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