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

 

三、设置项类型

在S60平台有十种不同的设置项类型，下面我们来仔细介绍这些类型及它的资源结构。

3.1 Binary Switch

二进制开关是最简单的设置项类型了，它允许设置成开和关，并且不需要单独的设置页，在设置列表中就可以改变。二进制开关设置项类型返回一个布尔（TBool）型变量在应用程序设置数据中。设置项类中使用的二进制开关类型是CAknBinaryPopupSettingItem。

 

    图1 二进制开关设置项

 

 

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

RESOURCE AVKON_SETTING_ITEM_LIST r_setting_list_setting_binary { flags= EAknSettingItemNumberedStyle; title = qtn_exsl_outline07; initial_number = 1; items = { AVKON_SETTING_ITEM { identifier = EAknExSettingBinary; setting_page_resource = r_binary_setting _page; associated_resource = r_popup_setting_binary_texts; name = qtn_exsl_binary_title; } }; } RESOURCE AVKON_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 = { AVKON_ENUMERATED_TEXT { value=1; text = qtn_exsl_texts_on; }, AVKON_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 AVKON_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 AVKON_SETTING_ITEM_LIST r_setting_list_setting_text { flags= EAknSettingItemNumberedStyle; title = qtn_exsl_outline01; initial_number = 1; items = { AVKON_SETTING_ITEM { identifier = EAknExSettingText; setting_page_resource = r_text_setting_page; name = qtn_exsl_text_title; } }; } RESOURCE AVKON_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 AVKON_SETTING_ITEM_LIST r_setting_list_setting_enumtext { flags= EAknSettingItemNumberedStyle; title = qtn_exsl_outline04; initial_number = 1; items = { AVKON_SETTING_ITEM { identifier = EAknExSettingEnumText; setting_page_resource = r_enumtext_setting_page; associated_resource = r_popup_setting_list; name = qtn_exsl_enumtext_title; } }; } RESOURCE AVKON_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 AVKON_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 = { AVKON_ENUMERATED_TEXT {value = 0;text = qtn_exsl_item_list0;}, AVKON_ENUMERATED_TEXT {value = 1;text = qtn_exsl_item_list1;}, AVKON_ENUMERATED_TEXT {value = 2;text = qtn_exsl_item_list2;}, . . . AVKON_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 AVKON_SETTING_ITEM_LIST r_setting_list_setting_pw { flags= EAknSettingItemNumberedStyle; title = qtn_exsl_outline08; initial_number = 1; items = { AVKON_SETTING_ITEM { identifier = EAknExSettingPassAlph; setting_page_resource = r_alpha_password_setting_page; name = qtn_exsl_alpha_title; } }; } RESOURCE AVKON_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 AVKON_SETTING_ITEM_LIST r_setting_list_setting_pin { flags= EAknSettingItemNumberedStyle; title = qtn_exsl_outline09; initial_number = 1; items = { AVKON_SETTING_ITEM { identifier = EAknExSettingPassNumber; setting_page_resource = r_ol09_numeric_password_setting_page; name = qtn_exsl_numeric_title; } }; } RESOURCE AVKON_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 AVKON_SETTING_ITEM_LIST r_setting_list_setting_slider { flags= EAknSettingItemNumberedStyle; title = qtn_exsl_outline02; initial_number = 1; items = { AVKON_SETTING_ITEM { identifier = EAknExSettingSlider; setting_page_resource = r_slider_setting_page; name = qtn_exsl_slider_title; } }; } RESOURCE AVKON_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 AVKON_SETTING_ITEM_LIST r_setting_list_setting_volume { flags= EAknSettingItemNumberedStyle; title = qtn_exsl_outline03; initial_number = 1; items = { AVKON_SETTING_ITEM { identifier = EAknExSettingVolume; setting_page_resource = r_volume_setting_page; name = qtn_exsl_volume_title; } }; } RESOURCE AVKON_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 AVKON_SETTING_ITEM_LIST r_setting_list_setting_time { flags= EAknSettingItemNumberedStyle; title = qtn_exsl_outline06; initial_number = 1; items = { AVKON_SETTING_ITEM { identifier = EAknExSettingTime; setting_page_resource = r_time_setting_page; name = qtn_exsl_time_title; } }; } RESOURCE AVKON_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 AVKON_SETTING_ITEM_LIST r_setting_list_setting_date { flags= EAknSettingItemNumberedStyle; title = qtn_exsl_outline05; initial_number = 1; items = { AVKON_SETTING_ITEM { identifier = EAknExSettingDate; setting_page_resource = r_date_setting_page; name = qtn_exsl_date_title; } }; } RESOURCE AVKON_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 AVKON_SETTING_ITEM_LIST r_setting_list_setting_ip { flags= EAknSettingItemNumberedStyle; title = qtn_exsl_outline10; initial_number = 1; items = { AVKON_SETTING_ITEM { identifier = EAknExSettingIpAddress; setting_page_resource = r_ip_address_setting_page; name = qtn_exsl_ip_editor_title; } }; } RESOURCE AVKON_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; }