ResourceMap.GetSubtree | getSubtree method

Returns a ResourceMap that represents a subtree of another ResourceMap, typically used to access a particular resource file within an app package.

Syntax

var resourceMap = resourceMap.getSubtree(reference);

Parameters

reference

Type: String [JavaScript] | Platform::String [C++]

A resource map identifier that identifies the root of the new subtree.

Note  The resource identifier is treated as a URI fragment, subject to URI semantics. For example, getSubtree("Caption%20") is treated as getSubtree("Caption "). Do not use "?" or "#" in resource identifiers, as they terminate the named resource path. For example, "Foo?3" is treated as "Foo".

Return value

Type: ResourceMap

The subtree ResourceMap.

Remarks

The term "subtree" is not actually true. This method can also find ancestor, sibling and cousin maps to this resource map, as well as top-level maps. It returns the resource map represented by a given resource map identifier, relative to this resource map. This method is typically used to make simpler references to a particular subset of resources, such as a single resource file, or a directory of files.

Requirements

See also

ResourceMap

Build date: 12/4/2012