WinJS.Resources.getString function

Retrieves the resource string that has the specified resource identifier.

Syntax

var object = WinJS.Resources.getString(resourceId);

Parameters

• resourceId
  Type: String

  The resource ID of the string to retrieve.

Return value

Type: Object

An object that can contain these properties:

• value
  The value of the requested string. This property is always present.

• empty
  A value that specifies whether the requested string wasn't found. If it's true, the string wasn't found. If it's false or undefined, the requested string was found.

• lang
  The language of the string, if specified. This property is present only for multi-language resources.

Examples

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

var statusDiv = document.getElementById("statusMessage");
var str = WinJS.Resources.getString('scenario3Message');
statusDiv.textContent = str.value;
statusDiv.lang = str.lang; // Set the lang attribute to ensure proper font choice.

Requirements

Minimum WinJS version	WinJS 1.0
Namespace	WinJS.Resources

See also

WinJS.Resources

Application resources and localization sample