Sets/gets VARIANT to be used as a
"root" value. This is the value returned by the Item default property when used
without key/index parameter.Syntax:
object.Root = variable
variable = object.Root
IDL definition:
[propget, id(6), helpstring("gets Root item")] HRESULT Root([out, retval] VARIANT *pVal);
[propput, id(6), helpstring("sets Root item")] HRESULT Root([in] VARIANT vVal);
Parameters:
object - Previously created VarDictionary object
variable - variable that will receive (or will be assigned) the root
value.
Examples:
var vardict = Server.CreateObject("newobjects.utilctls.VarDictionary");
vardict.Root = "root";
Dim vardict
Set vardict = Server.CreateObject("newobjects.utilctls.VarDictionary")
vardict.Root = "root"
Remarks:
If not specified VT_NULL is used.
Also the collection behavior depends on the firstItemAsRoot
property. If it is set to true the first item from the colelction will
be returned instead off the value set using the Root property. If
the collection is empty then the value of the Root property will
be returned in both cases.
Applies to: VarDictionary
See also: Item property,
firstItemAsRoot
|