Description
Use the Properties property to obtain a StoredObjectProperty object that provides a scripting interface to a property value that is stored in the property collection to which StoredObject provides access to.
Declaration
StoredObjectObj.Properties(Index)
| Read-Only Property | A StoredObjectProperty object |
| StoredObjectObj | An expression, variable or parameter that specifies a reference to a StoredObject object | |||
| Index | [in] | Required | Integer | |
Applies To
The property is applied to the following object:
Parameters
The property has the following parameter:
Index
Specifies the index of the desired property value. The first property value has index 0, the second - 1, the third - 2 an so on. The total number of stored properties is specified by the PropertyCount property.
Property Value
A StoredObjectProperty object that provides a scripting interface to the desired stored property.
Remarks
If you use Python or DelphiScript, you should enclose the parameter of the StoredObject.Properties property in square brackets: StoredObject.Properties[Index].
Example
The following code demonstrates how you can access the desired item of the Objects collection and the properties stored in this item.
JavaScript, JScript
{
// Obtains the specified property collection
StoredObject = Objects.Items("MyCollection");
Log.Message("The total number of property values stored by the collection: " + StoredObject.PropertyCount);
// Access the specified stored property
StoredObjectProperty = StoredObject.Properties(0);
// --or--
// StoredObjectProperty = StoredObject.PropertyByName("Caption");
PropertyName = StoredObjectProperty.Name;
PropertyValue = StoredObjectProperty.Value;
Log.Message(PropertyName + " = " + PropertyValue);
}
Python
def Test1():
# Obtains the specified property collection
StoredObject = Objects.Items("MyCollection")
Log.Message("The total number of property values stored by the collection: " + str(StoredObject.PropertyCount))
# Access the specified stored property
StoredObjectProperty = StoredObject.Properties[0]
# --or--
# StoredObjectProperty = StoredObject.PropertyByName["Caption"]
PropertyName = StoredObjectProperty.Name
PropertyValue = StoredObjectProperty.Value
Log.Message(PropertyName + " = " + str(PropertyValue))VBScript
' Obtains the specified property collection
Set StoredObject = Objects.Items("MyCollection")
Log.Message("The total number of property values stored by the collection: " & StoredObject.PropertyCount)
' Access the specified stored property
Set StoredObjectProperty = StoredObject.Properties(0)
' --or--
' Set StoredObjectProperty = StoredObject.PropertyByName("Caption")
PropertyName = StoredObjectProperty.Name
PropertyValue = StoredObjectProperty.Value
Log.Message(PropertyName & " = " & PropertyValue)
End Sub
DelphiScript
begin
// Obtains the specified property collection
StoredObject := Objects.Items('MyCollection');
Log.Message('The total number of property values stored by the collection: ' + StoredObject.PropertyCount);
// Access the specified stored property
StoredObjectProperty := StoredObject.Properties(0);
// --or--
// StoredObjectProperty := StoredObject.PropertyByName('Caption');
PropertyName := StoredObjectProperty.Name;
PropertyValue := StoredObjectProperty.Value;
Log.Message(PropertyName + ' = ' + PropertyValue);
end;
C++Script, C#Script
{
// Obtains the specified property collection
StoredObject = Objects["Items"]("MyCollection");
Log["Message"]("The total number of property values stored by the collection: " + StoredObject["PropertyCount"]);
// Access the specified stored property
StoredObjectProperty = StoredObject["Properties"](0);
// --or--
// StoredObjectProperty = StoredObject["PropertyByName"]("Caption");
PropertyName = StoredObjectProperty["Name"];
PropertyValue = StoredObjectProperty["Value"];
Log["Message"](PropertyName + " = " + PropertyValue);
}
See Also
PropertyCount Property
PropertyByName Property
StoredObjectProperty Object