Criteria for modifying a system attribute value

The criteria object specifies the new value for the system attribute.

The criteria object has a three properties: Entity, Key, and SystemData. These are described in the following table.

Table: Criteria object properties

Property

Description

Type

Value

criteria.Entity

Specifies the entity of the system attribute.

Together with Key, this specifies the system attribute to modify.

For more information about entities, see section System attributes.

string

For a complete list of supported entities, see section Supported system attributes (entities and keys).

For example: "Display"

criteria.Key

Specifies the key of the system attribute. The available keys depend on the entity.

Together with Entity, this specifies the system attribute to modify.

For more information about keys, see section System attributes.

string

For a complete list of supported keys per entity, see the Key column of the tables in section Supported system attributes (entities and keys).

For example: "Wallpaper"

criteria.SystemData

Specifies the new value for the system attribute.

The SystemData object always has a single property, which represents the system attribute value. The type and content of the property depend on the system attribute (specifically, on the system data type used for input).

Typically, the property contains status information represented by a number or string. The property can also be an object for representing more complex values, such as drive information.

For more information about system attribute values, see section Supported system attributes (entities and keys).

object

The object property depends on the system attribute. See the Input column cell for the appropriate system attribute in section Supported system attributes (entities and keys).

For example, the Display - Wallpaper system attribute takes StringData (string) as input for SetInfo:

SystemData.StringData = "C://Data//Others//wallpaper.jpeg"
© Nokia 2008.