S60平台：Avkon UI 资源-设置列表--S60 Platform： Avkon UI Resources- Setting Lists翻译连载四

三、设置项类型
在S60平台有十种不同的设置项类型，下面我们来仔细介绍这些类型及它的资源结构。
3.1 Binary Switch
二进制开关是最简单的设置项类型了，它允许设置成开和关，并且不需要单独的设置页，在设置列表中就可以改变。二进制开关设置项类型返回一个布尔（TBool）型变量在应用程序设置数据中。设置项类中使用的二进制开关类型是CAknBinaryPopupSettingItem。




图1 二进制开关设置项



下面是一个二进制开关资源定义的例子：

RESOURCE ***KON_SETTING_ITEM_LIST r_setting_list_setting_binary 
{ 
flags= EAknSettingItemNumberedStyle; 
title = qtn_exsl_outline07; 
initial_number = 1; 
items = 
{ 
***KON_SETTING_ITEM 
{ 
identifier = EAknExSettingBinary; 
setting_page_resource = r_binary_setting _page; 
associated_resource = r_popup_setting_binary_texts; 
name = qtn_exsl_binary_title; 
} 
}; 
} 
RESOURCE ***KON_POPUP_SETTING_TEXTS r_popup_setting_binary_texts 
{ 
flags = 0; 
setting_texts_resource = r_on_off_texts; 
popped_up_texts_resource = r_popped_up_on_off_texts; 
} 
RESOURCE ARRAY r_on_off_texts
{ 
items = 
{ 
***KON_ENUMERATED_TEXT { value=1; text = qtn_exsl_texts_on; }, 
***KON_ENUMERATED_TEXT { value=0; text = qtn_exsl_texts_off; } 
}; 
} 
RESOURCE ARRAY r_popped_up_on_off_texts 
{ 
items = 
{ 
LBUF { txt = qtn_exsl_texts_enabled; }, 
LBUF { txt = qtn_exsl_texts_disabled; } 
}; 
} 
RESOURCE ***KON_SETTING_PAGE r_binary_setting_page 
{ 
number= 0; 
label= qtn_exsl_binary_title; 
type = EAknCtPopupSettingList; 
}

3.2 Text Editor
文本设置项允许用户输入设置的值。这些设置值存储在用户指定描述符（user-specified descriptor）中。设置项类使用的文本编辑类型是CAknTextSettingItem。






图2 文本设置项和文本设置页
下面是文本编辑设置项资源定义的例子：

RESOURCE ***KON_SETTING_ITEM_LIST r_setting_list_setting_text 
{ 
flags= EAknSettingItemNumberedStyle; 
title = qtn_exsl_outline01; 
initial_number = 1; 
items = 
{ 
***KON_SETTING_ITEM 
{ 
identifier = EAknExSettingText; 
setting_page_resource = r_text_setting_page; 
name = qtn_exsl_text_title; 
} 
};
} 
RESOURCE ***KON_SETTING_PAGE r_text_setting_page 
{ 
number = TEXT_SETTING_PAGE_NUMBER; 
label = qtn_exsl_text_title; 
type = EEikCtEdwin; 
editor_resource_id = r_settinglist_edwin; 
} 
RESOURCE EDWIN r_settinglist_edwin 
{ 
width = TEXT_SETTING_PAGE_WIDTH; 
lines = TEXT_SETTING_PAGE_LINES; 
maxlength = TEXT_SETTING_PAGE_MAXLENGTH20; 
}

3.3 Enumerated Text
枚举文本设置项为用户提供一个选择列表。它也允许为设置项再输入一个文本值，通过选择弹出菜单的“Other”来完成它。这样实际上就有了三种不同的枚举文本视图：设置列表中包含设置项，设置页显示多种选择，文本编辑器输入非预定义的文本。这些设置值存储在设置项构造的描述符中。设置项类使用枚举文本类型是CAknEnumeratedTextPopupSettingItem。






图3 枚举文本设置项和设置页





图4 枚举文本、文本编辑器






下面是枚举文本设置项的资源定义的例子：

RESOURCE ***KON_SETTING_ITEM_LIST r_setting_list_setting_enumtext 
{ 
flags= EAknSettingItemNumberedStyle; 
title = qtn_exsl_outline04; 
initial_number = 1; 
items = 
{ 
***KON_SETTING_ITEM 
{ 
identifier = EAknExSettingEnumText; 
setting_page_resource = r_enumtext_setting_page; 
associated_resource = r_popup_setting_list; 
name = qtn_exsl_enumtext_title; 
} 
}; 
} 
RESOURCE ***KON_SETTING_PAGE r_enumtext_setting_page 
{ 
number= 1; 
label= qtn_exsl_enumtext_title; 
type = EAknCtPopupSettingList; 
editor_resource_id = r_popup_setting_list_new_entry; 
} 
RESOURCE ***KON_POPUP_SETTING_TEXTS r_popup_setting_list 
{ 
setting_texts_resource = r_settinglist_page_list; 
popped_up_texts_resource = r_settinglist_list_item_array; 
} 
RESOURCE ARRAY r_settinglist_page_list 
{ 
items = 
{ 
***KON_ENUMERATED_TEXT {value = 0;text = qtn_exsl_item_list0;}, 
***KON_ENUMERATED_TEXT {value = 1;text = qtn_exsl_item_list1;}, 
***KON_ENUMERATED_TEXT {value = 2;text = qtn_exsl_item_list2;}, 
. . . 
***KON_ENUMERATED_TEXT {value = 9;text = qtn_exsl_item_list9;} 
}; 
} 
RESOURCE ARRAY r_settinglist_list_item_array 
{ 
items = 
{
 
LBUF { txt = qtn_exsl_item_list0; }, 
LBUF { txt = qtn_exsl_item_list1; }, 
LBUF { txt = qtn_exsl_item_list2; }, 
. . . 
LBUF { txt = qtn_exsl_item_list9; } 
}; 
}

3.4 Alphanumeric Password Editor
字母数字密码编辑器
密码设置项允许保密数据。密码设置项允许输入字母或数字（3.5章节是数字密码编辑器）。设置值存储在设置项构造的描述符中。设置项类使用密码类型是
CAknPasswordSettingItem。






图5 字母密码设置项和密码设置页

下面是字母数字密码设置项的资源定义的例子：

RESOURCE ***KON_SETTING_ITEM_LIST r_setting_list_setting_pw 
{ 
flags= EAknSettingItemNumberedStyle; 
title = qtn_exsl_outline08; 
initial_number = 1; 
items = 
{ 
***KON_SETTING_ITEM 
{ 
identifier = EAknExSettingPassAlph; 
setting_page_resource = r_alpha_password_setting_page; 
name = qtn_exsl_alpha_title; 
} 
}; 
} 
RESOURCE ***KON_SETTING_PAGE r_alpha_password_setting_page 
{ 
number = ALPHA_PASSWORD_SETTING_PAGE_NUMBER; 
label = qtn_exsl_alpha_title; 
type = EEikCtSecretEd; 
editor_resource_id = r_settinglist_alpha_password; 
} 
RESOURCE SECRETED r_settinglist_alpha_password 
{
num_letters = ALPHA_PASSWORD_LENGTH_OF_STRING; 
}

3.5 Numeric Password Editor
密码设置项允许输入密码。密码设置项可以是字母数字或数字（PIN码）。设置值存储在设置项构造的描述符中。设置项类使用的密码类型是CAknPasswordSettingItem。






图6 数字密码设置项和设置页

下面是数字密码设置项资源定义的例子：

RESOURCE ***KON_SETTING_ITEM_LIST r_setting_list_setting_pin 
{ 
flags= EAknSettingItemNumberedStyle; 
title = qtn_exsl_outline09; 
initial_number = 1; 
items = 
{ 
***KON_SETTING_ITEM 
{ 
identifier = EAknExSettingPassNumber; 
setting_page_resource = 
r_ol09_numeric_password_setting_page; 
name = qtn_exsl_numeric_title; 
} 
}; 
} 
RESOURCE ***KON_SETTING_PAGE r_ol09_numeric_password_setting_page 
{ 
number = NUMERIC_PASSWORD_OL09_SETTING_PAGE_NUMBER; 
label = qtn_exsl_numeric_title; 
type = EAknCtNumericSecretEditor; 
editor_resource_id = r_settinglist_numeric_password; 
} 
RESOURCE NUMSECRETED r_settinglist_numeric_password 
{ 
num_code_chars = NUMERIC_PASSWORD_LENGTH_OF_STRING; 
}

3.6 Slider
滑块设置项允许用户指定一个整数值。这个整数值有个最小值和最大值，用滑动块控件选择指定的值。滑动块设置项的值存储在整型（TInt）变量中。滑动设置项类使用滑动块类型CAknSliderSettingItem。








图7 滑动设置项和设置页

下面是滑动设置项的资源定义的例子：

RESOURCE ***KON_SETTING_ITEM_LIST r_setting_list_setting_slider
{
flags= EAknSettingItemNumberedStyle;
title = qtn_exsl_outline02;
initial_number = 1;
items =
{
***KON_SETTING_ITEM
{
identifier = EAknExSettingSlider;
setting_page_resource = r_slider_setting_page;
name = qtn_exsl_slider_title;
}
};
}
RESOURCE ***KON_SETTING_PAGE r_slider_setting_page
{
number = SLIDER_SETTING_PAGE_NUMBER;
label = qtn_exsl_slider_title;
type = EAknCtSlider;
editor_resource_id = r_settinglist_slider;
}
RESOURCE SLIDER r_settinglist_slider
{
layout = EAknSettingsItemSliderLayout;
minvalue = SLIDER_SETTING_PAGE_MINVALUE;
maxvalue = SLIDER_SETTING_PAGE_MAXVALUE;
step = SLIDER_SETTING_PAGE_STEP;
valuetype = EAknSliderValuePercentage;
minlabel = qtn_slider_minlabel; maxlabel = qtn_slider_maxlabel;
}

3.7 Volume Control
音量设置项存储一个整型值变量，类似于滑动设置项。然而，音量控件可供选择的范围是1到10，也没有在设置页上摆放可以拖动的控件。设置项类使用音量控件类型是CAknVolumeSettingItem。






图8 音量设置项和设置页

下面是音量控制设置项的资源定义的例子：

RESOURCE ***KON_SETTING_ITEM_LIST r_setting_list_setting_volume 
{ 
flags= EAknSettingItemNumberedStyle; 
title = qtn_exsl_outline03; 
initial_number = 1; 
items = 
{ 
***KON_SETTING_ITEM 
{ 
identifier = EAknExSettingVolume; 
setting_page_resource = r_volume_setting_page; 
name = qtn_exsl_volume_title; 
} 
}; 
} 
RESOURCE ***KON_SETTING_PAGE r_volume_setting_page 
{ 
number = VOLUME_SETTING_PAGE_NUMBER; 
label = qtn_exsl_volume_title; 
type = EAknCtVolumeControl; 
editor_resource_id = r_settinglist_volume; 
} 
RESOURCE VOLUME r_settinglist_volume 
{ 
flags = ESettingsVolumeControl; 
value = VOLUME_SETTING_PAGE_VALUE; 
}

3.8 Time Editor
时间设置项用来设置时间值，与之相关联设置项的变量类型是TTime。设置项类使用时间和日期的设置项类型是CAknTimeOrDateSettingItem，用第二个构造器的参数指定额外的类型。








图9 时间设置项和设置页

下面是时间设置项资源定义的例子：

RESOURCE ***KON_SETTING_ITEM_LIST r_setting_list_setting_time
{
flags= EAknSettingItemNumberedStyle;
title = qtn_exsl_outline06;
initial_number = 1;
items =
{
***KON_SETTING_ITEM
{
identifier = EAknExSettingTime;
setting_page_resource = r_time_setting_page;
name = qtn_exsl_time_title;
}
};
}
RESOURCE ***KON_SETTING_PAGE r_time_setting_page
{
number = TIME_SETTING_PAGE_NUMBER;
label = qtn_exsl_time_title;
type = EEikCtTimeEditor;
editor_resource_id = r_settinglist_time_editor;
}
RESOURCE TIME_EDITOR r_settinglist_time_editor
{
minTime = TIME
{
second = TIME_EDITOR_MIN_SECOND;
minute = TIME_EDITOR_MIN_MINUTE;
hour = TIME_EDITOR_MIN_HOUR;
};
maxTime = TIME
{
second = TIME_EDITOR_MAX_SECOND;
minute = TIME_EDITOR_MAX_MINUTE;
hour = TIME_EDITOR_MAX_HOUR;
};
}

3.9 Date Editor
日期设置项类似于时间设置项类型，区别在于输入的是日期值。








图10 日期设置项和设置页

下面是日期设置项资源定义的例子：

RESOURCE ***KON_SETTING_ITEM_LIST r_setting_list_setting_date 
{ 
flags= EAknSettingItemNumberedStyle; 
title = qtn_exsl_outline05; 
initial_number = 1; 
items = 
{ 
***KON_SETTING_ITEM 
{ 
identifier = EAknExSettingDate; 
setting_page_resource = r_date_setting_page; 
name = qtn_exsl_date_title; 
} 
}; 
} 
RESOURCE ***KON_SETTING_PAGE r_date_setting_page 
{ 
label= qtn_exsl_date_title; 
type = EEikCtDateEditor; 
editor_resource_id = r_settinglist_date; 
} 
RESOURCE DATE_EDITOR r_settinglist_date 
{ 
minDate= DATE {year=1980;}; 
maxDate= DATE {year=2060;}; 
flags=0; 
}

3.10 IP Address Editor
IP地址设置项类型允许用户进行IP地址设置，与之对应的设置项变量类型是TInetAddr。设置项类使用的IP地址类型是CAknIpFieldSettingItem。






图11 IP地址设置项和设置页

下面是IP地址设置项资源定义的例子：

RESOURCE ***KON_SETTING_ITEM_LIST r_setting_list_setting_ip 
{ 
flags= EAknSettingItemNumberedStyle; 
title = qtn_exsl_outline10; 
initial_number = 1; 
items = 
{ 
***KON_SETTING_ITEM 
{ 
identifier = EAknExSettingIpAddress; 
setting_page_resource = r_ip_address_setting_page; 
name = qtn_exsl_ip_editor_title; 
} 
}; 
} 
RESOURCE ***KON_SETTING_PAGE r_ip_address_setting_page 
{ 
label= qtn_exsl_ip_editor_title; 
type = EAknCtIpFieldEditor; 
editor_resource_id = r_settinglist_ip_editor; 
} 
RESOURCE IP_FIELD_EDITOR r_settinglist_ip_editor 
{ 
min_field_values = IP_FIELD 
{ 
first_field = IP_EDITOR_MIN_FIELD_VALUE; 
second_field = IP_EDITOR_MIN_FIELD_VALUE; 
third_field = IP_EDITOR_MIN_FIELD_VALUE; 
fourth_field = IP_EDITOR_MIN_FIELD_VALUE; 
}; 
max_field_values = IP_FIELD 
{ 
first_field = IP_EDITOR_MAX_FIELD_VALUE; 
second_field = IP_EDITOR_MAX_FIELD_VALUE; 
third_field = IP_EDITOR_MAX_FIELD_VALUE; 
fourth_field = IP_EDITOR_MAX_FIELD_VALUE; 
}; 
flags = 0; 
}