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;