Promotic

Object PmaDataTable (Data Table)

Description:
See: PmaDataTable - Deatiled object description

The object serves for the definition of the data table (2-dimensional array). Data in this table are ordered into columns and rows. It is the analogy of the database table. A data type and a column name can be defined for the column.

No other Pma objects can be created in this object.
This object can be created in objects: PmaRoot, PmaFolder, PmaPrototype. Multiple objects of this type can be created in such objects.
This object adds variables into the calculation of the application size, which influences the basic runtime licence type/size (see: Licences for PROMOTIC runtime environment).
This object inherits properties, methods and events of the PmaObject object.
Properties and methods of this object:
ColsThe number of columns
EndOfTransferFires the onEndOfTransfer event
FindValueSearch for the row with the specified value
GetArrayCreates an array of values from selected data items of the object
GetCellValuereturns the value of the table cell
GetColParamReturns the column parameter
InsertColInsert of new column
InsertRowInsert new column
ItemAccess to table values (obsolete)
LoadFromFileLoading data for this object from the file
LoadFromStringAssignment of selected data item values of the object from the string value
MaxColsMaximum number of columns
MaxRowsMaximum row number
ReadFromWebReading data from Web server in the XML format
RemoveColRemoves the column
RemoveRowRemoves the row
RowsThe number of rows
SaveToFileSaving data of this object into the file
SaveToStringCreates a string value from selected data item values of the object
SetArrayAssignment of the array of values to the data items of the object
SetCellValueSets the value of the table cell
SortSort of rows by values in the specified column
WebClientIsReadyDetects whether the object is ready to write/read to Web server
WriteToWebSending data to Web server in the XML format
Properties and methods inherited from the PmaObject object:
AddEventRegisters a function into selected event
GetInfoReturns the Info object with the specified name
GetOwnedByIndexReturns the subobject defined by its index
GetOwnedByNameReturns reference to the subobject defined by its name
GetOwnedByTypeArray of references to the subobjects
GetOwnedNumReturns number of subobjects in the object
GetParReading the value of the Pma object parameter (or its parents)
GetPathNameObject name with the path to this object
GetPermissionReturns permission of corresponding operation from object
MethodsAccess to designer's methods of this object
NameObject name (without the path)
ParentReturns reference to the parent Pma object
PmReturns reference to the Pma object or to its implementation subobject
RemoveEventUn-registers the function in the specified event
RootReturns reference to the root application object PmaRoot
Events of this object:
onEndOfTransferIs triggered after ending the data transfer
Events inherited from the PmaObject object:
onStartIs triggered for each object in the runtime only once at the beginning
onStopIs triggered for each Pma object in the runtime mode only once at the stop of the application
Configuration tabs:
ObjectGeneral information about the object
EventsDefinition of object events algorithms
DataTableDefinition of the data table range
ColumnsDefinition of table columns
PermissionsObject permissions
Web serverThe link-up of the object to Web server
See also:
- PmaData (object)

History:
Pm9.00.00: Object name changed: PmDataTable -> PmaDataTable
Pm8.03.15: The first column can now be defined as Identifier type. This row identifier can be used for example in the GetCellValue method for addressing the table cell.
Pm8.03.14: On the "Columns" tab there is a new "Read only" configurator for each new column. The variable in such column can be written only once and these variables are not included into the total variable count of the application. This fact then affects the type of basic runtime licence to be used. See "Read only" columns.
PROMOTIC 9.0.23 SCADA system documentation MICROSYS, spol. s r.o.

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