Promotic

Items - method of the PmaPanel object

Description:
Returns reference to Pmg object in the panel.
Using this method is not recommended. It is not proper to make references to Pmg objects outside the panel that contains the object (one of the problems is that such thing is not functional in the Web panel). In order to obtain the reference to Pmg object in the panel (in events of Pmg objects) it is recommended to use the PmgObject.Items method.
This method/property/event is considered obsolete and is functional only if the "Level of integration of the panel viewer and the local application" configurator is set to full - FULL access from scripts to the whole application (only for VBScript) and if the "Enable multiple opening of local panel" configurator IS NOT SET.
Instead of this method it is better to use the PmgObject.Items method.
Syntax:
Object Items(String sPath, [Long nAttr])
Parameters:
sPath(String) Absolute path to Pmg object (case sensitive text).
The path describes the location of the object in the tree structure of the immersed Pmg objects. Each tree level adress is separated by the / character. The immersed Pmg object is referrenced by its name. The superior Pmg object is referrenced by .. characters. The absolute path starts with the / character and describes the path to Pmg object from beginning of the tree structure. The relative path starts with the name of the immersed Pmg object or by reference to superior Pmg object by .. characters, or by reference to itself ., describes the path to another Pmg object relative to itself.
The immersed implementation subobject (other than PmgObject type) is referrenced by # character, followed by the implementation subobject type definition (e.g. #vars). It means that the # addressing leaves the panel Pmg objects tree and starts to address the implementation subobjects. For example "/text0/#vars/Temperature".
nAttr[optional] (Long) It allows to change the behavior of the method.
0 (default) - Default behavior.
1 - When referencing the non-existing object, the global error of the INFO system will not be generated.
Note:
Using this method over the PmaPanel object is not recommended (it is not functional for example for Web panels). It can be used properly only if the Pmg objects need to be affected directly in the Pma objects tree. Usually (e.g. in events of Pmg objects) it is much better to use the PmgObject.Items method, i.e. to reach the Pmg object through another Pmg object.
Examples see the PmgObject.Items method.

In order to create the variable of the Object type containing reference to Pmg object or its implementation subobject see also: #pragma variable x = PmgObjectRef("path").
Example:
Writing the 0 value into the variable "Temperature" of the Pmg object "text0" immersed into the superior object named "box0". The reference to the object is absolute.
VBScriptSelect and copy to clipboard

pMe.Pm("/Panel").Items("/text0/#vars/Temperature") = 0
PROMOTIC 9.0.27 SCADA system documentation MICROSYS, spol. s r.o.

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