ResourceQualifierVectorView ResourceQualifierVectorView ResourceQualifierVectorView ResourceQualifierVectorView Class

An unchangeable view into a vector of ResourceQualifier objects.

Syntax

Declaration

public sealed class ResourceQualifierVectorViewpublic sealed class ResourceQualifierVectorViewPublic NotInheritable Class ResourceQualifierVectorViewpublic sealed class ResourceQualifierVectorView

Remarks

Collection member lists

For JavaScript, ResourceQualifierVectorView has the members shown in the member lists. In addition, ResourceQualifierVectorView supports a length property, members of Array.prototype, and using an index to access items.

Enumerating the collection in C# or Microsoft Visual Basic

A ResourceQualifierVectorView is enumerable, so you can use language-specific syntax such as foreach in C# to enumerate the items in the collection. The compiler does the type-casting for you and you won't need to cast to IEnumerable<ResourceQualifier> explicitly. If you do need to cast explicitly, for example if you want to call GetEnumerator, cast to IEnumerable<T> with a ResourceQualifier constraint.

Examples

This example is based on scenario 13 of the Application resources and localization sample. See the sample for the more complete solution.

// Create a ResourceContext.
var resourceContext = new Windows.ApplicationModel.Resources.Core.ResourceContext();

// Set the specific context for lookup of resources.
var qualifierValues = resourceContext.qualifierValues;
qualifierValues["language"] = "en-US";
qualifierValues["contrast"] = "standard";
qualifierValues["scale"] = "140";
qualifierValues["homeregion"] = "021"; // Northern America

// Resources actually reside within Scenario13 Resource Map.
var resourceIds = [
    '/Scenario13/languageOnly',
    '/Scenario13/scaleOnly',
    '/Scenario13/contrastOnly',
    '/Scenario13/homeregionOnly',
    '/Scenario13/multiDimensional',
];

var output = { str: "" };
resourceIds.forEach(function (resourceId) {
    renderNamedResource(resourceId, resourceContext, output);
});

function renderNamedResource(resourceId, resourceContext, output) {
    output.str += "Resource ID " + resourceId + ":\n";
    // Lookup the resource in the mainResourceMap (the one for this package).
    var namedResource = Windows.ApplicationModel.Resources.Core.ResourceManager.current.mainResourceMap.lookup(resourceId);

    // Return a ResourceCandidateVectorView of all possible resources candidates
    // resolved against the context in order of appropriateness.
    var resourceCandidates = namedResource.resolveAll(resourceContext);

    resourceCandidates.forEach(function (candidate, index) {
        renderCandidate(candidate, index, output);
    });
    output.str += "\n";
}

function renderCandidate(candidate, index, output) {
    // Get all the various qualifiers for the candidate (such as language, scale, contrast).
    candidate.qualifiers.forEach(function (qualifier) {
        output.str += "qualifierName: " + qualifier.qualifierName + "\n";
        output.str += "qualifierValue: " + qualifier.qualifierValue + "\n";
        output.str += "isDefault: ";
        output.str += (qualifier.isDefault) ? "true\n" : "false\n";
        output.str += "isMatch: ";
        output.str += (qualifier.isMatch) ? "true\n" : "false\n";
        output.str += "score: " + qualifier.score + "\n";
        output.str += "\n";
    });
}

Properties summary

Gets the number of ResourceQualifier objects in the view.

Methods summary

Returns an iterator to enumerate the items in the view.

Returns the ResourceQualifier at the specified index in the view.

Returns the ResourceQualifier objects that start at the specified index in the view.

Returns the index of a specified ResourceQualifier in the view.

Properties

  • Size
    Size
    Size
    Size

    Gets the number of ResourceQualifier objects in the view.

    public uint Size { get; }public uint Size { get; }Public ReadOnly Property Size As uintpublic uint Size { get; }

    Property Value

    • uint
      uint
      uint
      uint

      The number of objects in the view.

Methods

  • First()
    First()
    First()
    First()

    Returns an iterator to enumerate the items in the view.

    public IIterator<ResourceQualifier> First()public IIterator<ResourceQualifier> First()Public Function First() As IIterator( Of ResourceQualifier )public IIterator<ResourceQualifier> First()

    Returns

    • The iterator. The current position of the iterator is index 0, or the end of the view if the view is empty.

  • GetAt(UInt32)
    GetAt(UInt32)
    GetAt(UInt32)
    GetAt(UInt32)

    Returns the ResourceQualifier at the specified index in the view.

    public ResourceQualifier GetAt(UInt32 index)public ResourceQualifier GetAt(UInt32 index)Public Function GetAt(index As UInt32) As ResourceQualifierpublic ResourceQualifier GetAt(UInt32 index)

    Parameters

    • index
      System.UInt32
      System.UInt32
      System.UInt32
      System.UInt32

      The zero-based index of the ResourceQualifier in the view to return.

    Returns

  • GetMany(UInt32, ResourceQualifier[])
    GetMany(UInt32, ResourceQualifier[])
    GetMany(UInt32, ResourceQualifier[])
    GetMany(UInt32, ResourceQualifier[])

    Returns the ResourceQualifier objects that start at the specified index in the view.

    public uint GetMany(UInt32 startIndex, ResourceQualifier[] items)public uint GetMany(UInt32 startIndex, ResourceQualifier[] items)Public Function GetMany(startIndex As UInt32, items As ResourceQualifier[]) As uintpublic uint GetMany(UInt32 startIndex, ResourceQualifier[] items)

    Parameters

    • startIndex
      System.UInt32
      System.UInt32
      System.UInt32
      System.UInt32

      The zero-based index of the start of the objects in the view to return.

    • items
      Windows.ApplicationModel.Resources.Core.ResourceQualifier[]
      Windows.ApplicationModel.Resources.Core.ResourceQualifier[]
      Windows.ApplicationModel.Resources.Core.ResourceQualifier[]
      Windows.ApplicationModel.Resources.Core.ResourceQualifier[]

      The objects in the view that start at startIndex.

    Returns

    • uint
      uint
      uint
      uint

      The number of objects returned.

  • IndexOf(ResourceQualifier, UInt32)
    IndexOf(ResourceQualifier, UInt32)
    IndexOf(ResourceQualifier, UInt32)
    IndexOf(ResourceQualifier, UInt32)

    Returns the index of a specified ResourceQualifier in the view.

    public bool IndexOf(ResourceQualifier value, UInt32 index)public bool IndexOf(ResourceQualifier value, UInt32 index)Public Function IndexOf(value As ResourceQualifier, index As UInt32) As boolpublic bool IndexOf(ResourceQualifier value, UInt32 index)

    Parameters

    Returns

    • bool
      bool
      bool
      bool

      A Boolean that is TRUE if the object is found, otherwise FALSE if the object is not found.

Device family

Windows 10 (introduced v10.0.10240.0)

API contract

Windows.Foundation.UniversalApiContract (introduced v1)

Attributes

Windows.Foundation.Metadata.ContractVersionAttribute
Windows.Foundation.Metadata.MarshalingBehaviorAttribute

Details

Assembly

Windows.ApplicationModel.Resources.Core.dll