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

本文章仅作学习与交流之用。如有转载，请联系本人。

书接上文！

 

字段	注释
flags	指定设置列表的编号类型（numbering style ）。如果没有指定，设置列表用EAknSettingItemNumberedStyle 来编号。与其相关联 的，EAknSettingItemIncludeHiddenInOrdinal 标记在列表上为隐藏设置项编号。
title	指定显示在列表顶端的设置列表的标题
initial_number	一个包含了此设置列表所有设置项的数组。设置项用AVKON_SETTING_ITEM 资源结构声明。
items	指定设置列表第一项的编号，默认值是1

STRUCT AVKON_SETTING_ITEM { WORD identifier = 0; LTEXT name =""; LLINK setting_page_resource = 0; WORD type=0xffff; LLINK setting_editor_resource = 0; LLINK associated_resource = 0; LTEXT empty_item_text = ""; LTEXT compulsory_ind_string = ""; LLINK reserved = 0; // Added for extensions }

 

字段	注释
identifier	指定一个设置列表的标识符。在CreateSettingItemL 函数中传给aIdentifier 参数。这些值在项目的.hrh 文件中用枚举做了定义。
name	指定项的标题
setting_page_resource	设置项相关设置页（setting page ）的资源定义，设置页资源用AVKON_SETTING_PAGE 资源结构声明
type	指定设置列表第一项的编号，默认值是1
associated_resource	相关联 的资源，与设置项的类型有关。例如，一个包含单选的弹出列表相关联的是枚举文本设置项。
compulsory_ind_string	为设置项指定强制指示字符串（compulsory indicator string ）（见图12 ）

Identifier 和setting_page_resource 在AVKON_SETTING_ITEM 结构中是必选的，其他为可选。 设置页相关联的设置项由AVKON_SETTING_ITEM 资源结构指定。

STRUCT AVKON_SETTING_PAGE { WORD number = EAknSettingPageNoOrdinalDisplayed; LTEXT label; LTEXT hint_text; LLINK softkey_resource = 0; LLINK menubar= 0; WORD type=0xffff; LLINK editor_resource_id = 0; LLINK invalid_contents_softkey_resource = 0; LLINK extension = 0; }

 

 

这个结构中最重要的字段概括如下。

 

字段	注释
type	指定用来编辑设置项的控件类型
editor_resource_id	指定编辑控件（editor control ）的资源
label	设置页的标题
hint_text	显示在导航格中的提示文本
number	设置项的编码。这个编码显示在设置页的左上角。如果默认值是EaknSettingPageNoOrdinalDisplayed ，这个编码将不会显示。

如果默认菜单栏（menu bar ）和命令按钮数组（CBA ）为0 ，在类中应该这样表示：

 

 

 

      Menubar resource = R_AVKON_MENUPANE_EMPTY; CBA resource = R_AVKON_SOFTKEYS_OK_CANCEL;