ResourceContext Class

Encapsule tous les facteurs (ResourceQualifiers) qui peuvent affecter la sélection des ressources.

Syntaxe


var resourceContext = Windows.ApplicationModel.Resources.Core.ResourceContext.GetForCurrentView();

Attributs

[MarshalingBehavior(Agile)]
[Threading(Both)]
[Version(0x06020000)]

Membres

ResourceContextClasse possède ces types de membres :

Constructeurs

ResourceContextClasse possède ces constructeurs.

ConstructeurDescription
ResourceContext Creates a cloned ResourceContext object.

 

Méthodes

The ResourceContext Classe a les méthodes suivantes. Avec C#, Visual Basic et C++, elle hérite également des méthodes de Object Classe.

MéthodeDescription
Clone Creates a clone of this ResourceContext, with identical qualifiers.
CreateMatchingContext Creates a new ResourceContext that matches a supplied set of qualifiers.
GetForCurrentView Gets a default ResourceContext associated with the current view for the currently running application.
GetForViewIndependentUse Gets a default ResourceContext not associated with any view.
OverrideToMatch Overrides the qualifier values supplied by this context to match a specified list of resolved ResourceQualifiers. Typically the resolved ResourceQualifiers are associated with a resource that was looked up earlier.
Reset() Resets the overridden values for all qualifiers on the given ResourceContext instance.
Reset(IIterable(String)) Resets the overridden values for the specified qualifiers on the given ResourceContext instance.
ResetGlobalQualifierValues() Removes any qualifier overrides from default contexts of all views across the app.
ResetGlobalQualifierValues(IIterable(String)) Removes qualifier overrides for the specified qualifiers from default contexts of all views across the app.
SetGlobalQualifierValue Applies a single qualifier value override to default contexts of all views for the current app.

 

Propriétés

Le ResourceContextClasse a les propriétés suivantes.

PropriétéType d'accèsDescription

Languages

Lecture/écritureGets or sets the language qualifier for this context.

QualifierValues

En lecture seuleGets a writable, observable map of all supported qualifiers, indexed by name.

 

Exemples

Cet exemple est basé sur le scénario 13 de l'Exemple de ressources et de localisation d'application. Pour obtenir la solution complète, consultez l'exemple.


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

// 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";
    });
}

Conditions requises

Client minimal pris en charge

Windows 8 [Applications Windows Store uniquement]

Serveur minimal pris en charge

Windows Server 2012 [Applications Windows Store uniquement]

Espace de noms

Windows.ApplicationModel.Resources.Core
Windows::ApplicationModel::Resources::Core [C++]

Métadonnées

Windows.winmd

Voir aussi

ResourceQualifier
Exemple de ressources et de localisation d'application

 

 

Afficher:
© 2014 Microsoft