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.
|
|---|
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 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