iOS Reference Library Apple Developer
Search

Multi Value Element

Table 1 lists the keys that may be placed in a dictionary that is associated with the PSTitleValueSpecifier type. When the user taps a preference containing a multi-value element, the Settings application displays a new page with the possible values to choose from. Upon selecting a value, the user is returned to the previous page, and the selected value is displayed in the preference row.

Table 1  Keys for the PSMultiValueSpecifier dictionary

Key

Value type

Description

Type (required)

String

The value of this key is always set to PSMultiValueSpecifier.

This key is required.

Title (required, localizable)

String

The user-readable string identifying the preference.

This key is required. The value of this key is localizable.

Key (required)

String

The preference key with which to associate the value. This is the string you use this to retrieve the preference value in your code.

This key is required.

DefaultValue (required)

Any

The default value for the preference key. This value is returned when the specified preferences key (represented by the Key entry) is not present in the preferences database.

This key is required.

Values (required)

Array

An array of the values that could be associated with the preference key (Key entry) in the defaults database. These values can be of any type. Each value should have a corresponding value in the Titles array.

Titles (required)

Array

An array of strings that represent user-readable versions of the values in the Values array. These are the strings that are actually displayed on the selection page. When a string is selected, the value at the matching index is stored in the defaults database.

The values in this array are localizable.

The Values and Titles keys let you associate human-readable strings with values in the defaults database that might otherwise be considered cryptic. The number of entries in both arrays must be equal. When a value at a given index is associated with the preference key, the string at the same index in the Titles array is displayed for the preference by the Settings application.




Last updated: 2010-04-27

Did this document help you? Yes It's good, but... Not helpful...