Promotic
WikipediaLinkedInYoutubeTwitterFacebook

Items - method of the PmaPanel object

Description:
Returns reference to the 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 panel Pmg object (in Pmg object events) 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 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 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 the 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 the Pmg object from the 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 PmaObject 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 tree of Pma objects. Usually (e.g. in Pmg object events) it is much better to use the PmgObject.Items method, i.e. to reach the Pmg object through another Pmg object.

For example 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 value 0 into the variable "Temperature" of the Pmg object "text0" immersed into the superior object named "panel0". The reference to the object is absolute.
VBScriptSelect and copy to clipboard

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

Send page remarkContact responsible person
© MICROSYS, spol. s r. o.Tavičská 845/21 703 00 Ostrava-Vítkovice