Multi Value Element
Table 1 lists the keys that may be placed in a dictionary that is associated with the PSMultiValueSpecifier
type. When the user taps a preference containing a multi-value element, the Settings app 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.
Key | Value type | Description |
---|---|---|
| String | The value of this key is always set to This key is required. |
| String | The user-readable string identifying the preference. This key is required. The value of this key is localizable. |
| 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. |
| Any | The default value for the preference key. This value is returned when the specified preferences key (represented by the This key is required. |
| Array | An array of the values that could be associated with the preference key ( |
| Array | An array of strings that represent user-readable versions of the values in the The values in this array are localizable. |
| Array | An array of strings that are abbreviated versions of the strings in the The values in this array are localizable. This key is available in iOS 5.0 and later. |
| Array | Indicates that the element is displayed only on specific types of devices. The value of this key is an array of strings with the supported idioms. Include the string “Phone” to display the element on iPhone and iPod touch. Include the string to “Pad” to display it on iPad. This key is available in iOS 4.2 and later. |
| Boolean | If Yes, the values are displayed in the localized sort order of the Titles array. This key is available in iOS 7.0 and later. |
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 app.
Copyright © 2016 Apple Inc. All Rights Reserved. Terms of Use | Privacy Policy | Updated: 2016-12-12