ItemEx - method of the PmaData object
Description:
The method returns object of the
PmVar type that represents one variable defined on the "
Data" tab.
Syntax:
Object ItemEx(Variant id, Long nAttr)
Parameters:
| id | (Variant) Specifies the variable. The value je:
- Name (String, case sensitive text, for example "d1") or
- Index (Long, zero-based index) |
|---|
| nAttr | (Long) It allows to change the behavior of the method.
0 (default) - default behavior (as the Item method).
|
|---|
Note:
The
PmVar object contains information about the variable (value, name, index, etc.).
If the variable does not exist, then error value (
null for
JavaScript or
Nothing pro
VBScript) is returned.
Nothing value can be tested by VBScript
Is operator.
Identifier #vars: The reference to
PmVar object can also be done directly by extending the path of the
Pm method by means of the
#vars identifier. This identifier can be used e.g. in the
Pm method, or in the "
PP - Data binding to Pma object property" data binding.
For example the method
Pm("/data/#vars/Temperature) returns the "Temperature" variable (
PmVar object) in the
data object (
PmaData object).
Identifier #ext: References to
Data extensions objects in the
PmVar variable can also be done directly by extending the path of the
Pm method using the
#ext identifier.
This can be used in the
Pm method or in PP binding
in the application and
in panels.
For example the method
pMe.
Pm("/data/#vars/Temperature/#ext/al") returns the data extension with
al identifier (
ExtAlarmAnalog) in the "Temperature" variable (
PmVar) in the
data object (
PmaData object).
Example1:
JavaScriptVBScriptSelect and copy to clipboard
var oData = pMe.Pm("/Data");
var oItemEx = oData.ItemEx(0);
// Access to the object that represents the variable
var value = oItemEx.Value;
// Reading the value
oItemEx.Value = 8;
// Writing the value
Dim oData, oItemEx
Set oData = pMe.Pm("/Data")
Set oItemEx = oData.ItemEx(0)
' Access to the object that represents the variable
Dim value
value = oItemEx.Value
' Reading the value
oItemEx.Value = 8
' Writing the valueExample2:
Test whether the variable named "Temperature3" exists:
JavaScriptVBScriptSelect and copy to clipboard
var oData = pMe.Pm("/Data");
var oItem = oData.ItemEx("Temperature3", 1);
if (!oItem)
{
// ...
}
Dim oData
Set oData = pMe.Pm("/Data")
Dim oItem
Set oItem = oData.ItemEx("Temperature3", 1)
If oItem Is Nothing Then
' ...
End If