📄 mainpage.dox
字号:
<p class=TableText><i><span class="hcp15">Contents</span></i></td></tr>
<tr>
<td style="width:15%;" width="15%" class="hcp18">
<p class=TableText>WORD</td>
<td style="width:20%;" width="20%" class="hcp18">
<p class=TableText>identifier = 0</td>
<td style="width:65%;" width="65%" class="hcp18">
<p class=TableText>Allowed value:<span class=CodeInText>EAknSettingItemListNumberedStyle</span></td></tr>
<tr>
<td style="width:15%;" width="15%" class="hcp18">
<p class=TableText>LTEXT</td>
<td style="width:20%;" width="20%" class="hcp18">
<p class=TableText>name=""</td>
<td style="width:65%;" width="65%" class="hcp18">
<p class=TableText>Title text</td></tr>
<tr>
<td style="width:15%;" width="15%" class="hcp18">
<p class=TableText>LLINK</td>
<td style="width:20%;" width="20%" class="hcp18">
<p class=TableText>setting_page_resource = 0;</td>
<td style="width:65%;" width="65%" class="hcp18">
<p class=TableText>Set the ordinal value</td></tr>
<tr>
<td style="width:15%;" width="15%" class="hcp18">
<p class=TableText>WORD</td>
<td style="width:20%;" width="20%" class="hcp18">
<p class=TableText>type=0xffff</td>
<td style="width:65%;" width="65%" class="hcp18">
<p class=TableText>item can be <span class=CodeInText>AVKON_SETTING_ITEM</span>
resource</td></tr>
<tr>
<td style="width:15%;" width="15%" class="hcp18">
<p class=TableText>LLINK</td>
<td style="width:20%;" width="20%" class="hcp18">
<p class=TableText>setting_editor_resource = 0</td>
<td style="width:65%;" width="65%" class="hcp18">
<p class=TableText> </td></tr>
<tr>
<td style="width:15%;" width="15%" class="hcp18">
<p class=TableText>LLINK</td>
<td style="width:20%;" width="20%" class="hcp18">
<p class=TableText>associated_resource = 0</td>
<td style="width:65%;" width="65%" class="hcp18">
<p class=TableText> </td></tr>
<tr>
<td style="width:15%;" width="15%" class="hcp18">
<p class=TableText>LTEXT</td>
<td style="width:20%;" width="20%" class="hcp18">
<p class=TableText>empty_item_text = ""</td>
<td style="width:65%;" width="65%" class="hcp18">
<p class=TableText> </td></tr>
<tr>
<td style="width:15%;" width="15%" class="hcp18">
<p class=TableText>LTEXT</td>
<td style="width:20%;" width="20%" class="hcp18">
<p class=TableText>compulsory_ind_string = ""</td>
<td style="width:65%;" width="65%" class="hcp18">
<p class=TableText> </td></tr>
</table></td></tr>
*
*
*
*
*
<tr>
<td style="width:100%;" width="100%" class="hcp18"><span class=CodeInText>AVKON_SETTING_PAGE</span></td></tr>
<tr>
<td style="width:100%;" width="100%" class="hcp18">
<table style="width:100%;" cellspacing="0" width="100%" border="1" class="hcp19">
<tr>
<td style="width:15%;" align="center" width="15%" class="hcp20"><i><span class="hcp15">Type</span></i></td>
<td style="width:20%;" align="center" width="20%" class="hcp20"><i><span class="hcp15">Signature</span></i></td>
<td style="width:65%;" align="center" width="65%" class="hcp20"><i><span class="hcp15">Contents</span></i></td></tr>
<tr>
<td style="width:15%;" width="15%" class="hcp18">WORD</td>
<td style="width:20%;" width="20%" class="hcp18">number</td>
<td style="width:65%;" width="65%" class="hcp18"><span class=CodeInText>EAknSettingPageNoOrdinalDisplayed</span></td></tr>
<tr>
<td style="width:15%;" width="15%" class="hcp18">LTEXT</td>
<td style="width:20%;" width="20%" class="hcp18">label</td>
<td style="width:65%;" width="65%" class="hcp18">label</td></tr>
<tr>
<td style="width:15%;" width="15%" class="hcp18">LTEXT</td>
<td style="width:20%;" width="20%" class="hcp18">hint_text</td>
<td style="width:65%;" width="65%" class="hcp18">hit text</td></tr>
<tr>
<td style="width:15%;" width="15%" class="hcp18">LLINK</td>
<td style="width:20%;" width="20%" class="hcp18">softkey_resource</td>
<td style="width:65%;" width="65%" class="hcp18">(default:0)</td></tr>
<tr>
<td style="width:15%;" width="15%" class="hcp18">LLINK</td>
<td style="width:20%;" width="20%" class="hcp18">menubar</td>
<td style="width:65%;" width="65%" class="hcp18">(default:0)</td></tr>
<tr>
<td style="width:15%;" width="15%" class="hcp18">WORD</td>
<td style="width:20%;" width="20%" class="hcp18">type</td>
<td style="width:65%;" width="65%" class="hcp18">Control type(default:0xffff)</td></tr>
<tr>
<td style="width:15%;" width="15%" class="hcp18">LLINK</td>
<td style="width:20%;" width="20%" class="hcp18">editor_resource_id</td>
<td style="width:65%;" width="65%" class="hcp18">link to resource of control, which is used as item of setting
list(default:0)</td></tr>
<tr>
<td style="width:15%;" width="15%" class="hcp18">LLINK</td>
<td style="width:20%;" width="20%" class="hcp18">invalid_contents_softkey_resource</td>
<td style="width:65%;" width="65%" class="hcp18">(default:0)</td></tr>
<tr>
<td style="width:15%;" width="15%" class="hcp18">LLINK</td>
<td style="width:20%;" width="20%" class="hcp18">extension</td>
<td style="width:65%;" width="65%" class="hcp18">(default:0)</td></tr>
</table></td></tr>
*
*
* \subsection Sub9 3.3.3.1.2 Resource example
*
<div align=left><table style="width:70%;" cellspacing="4" width="70%" bgcolor="#DDDDDD" class="hcp21">
<tr>
<td style="width: 100%;"
width=100%><i class="hcp22">Resource definition example
of SettingItemList</i></td></tr>
<tr>
<td style="width:100%;" bgcolor="#EEEEEE" width="100%" class="hcp23">
<p class=CodeInTable>RESOURCE AVKON_SETTING_ITEM_LIST r_aknexsettinglist_setting_list_setting_volume<br>
{<br>
flags= EAknSettingItemNumberedStyle;<br>
title = qtn_aknexsettinglist_outline03;<br>
initial_number = 1;<br>
items =<br>
{<br>
AVKON_SETTING_ITEM<br>
{<br>
identifier = EAknExSettingVolume;<br>
setting_page_resource = r_aknexsettinglist_volume_setting_page;<br>
name = qtn_aknexsettinglist_volume_title;<br>
}<br>
};<br>
} </td></tr>
</table>
*
* The application programmer needs to code a signature of identifier field in AVKON_SETTING_ITEM in resource data as unique in the application. See the above example, the identifier field is defined as EAknExSettingVolume in AVKON_SETTING_ITEM.
*
* This value is used to identify the control to be created in the application. See the following section. In addition, the signature of the setting_page_resource field in AVKON_SETTING_ITEM is defined as the following example resource:
*
<div align=left><table style="width:70%;" cellspacing="4" width="70%" bgcolor="#DDDDDD" class="hcp21">
<tr>
<td style="width: 100%;"
width=100%><i class="hcp22">Example of SettingItemList
resource definition</i></td></tr>
<tr>
<td style="width:100%;" bgcolor="#EEEEEE" width="100%" class="hcp23">
<p class=CodeInTable>RESOURCE AVKON_SETTING_PAGE r_aknexsettinglist_volume_setting_page<br>
{<br>
number = VOLUME_SETTING_PAGE_NUMBER;<br>
label = qtn_aknexsettinglist_volume_title;<br>
type = EAknCtVolumeControl;<br>
editor_resource_id = r_aknexsettinglist_volume;<br>
}<br>
<br>
RESOURCE VOLUME r_aknexsettinglist_volume<br>
{<br>
flags = ESettingsVolumeControl;<br>
value = VOLUME_SETTING_PAGE_VALUE;<br>
} </td></tr>
</table>
*
* Please note that EAknCtVolumeControl in the type field in r_aknexsettinglist_volume_setting_page resource and r_aknexsettinglist_volume in the editor_resource_id field are strongly related to the value EAknExSettingVolume in the identifier field of r_aknexsettinglist_setting_list_setting_volume.
*
* \subsection Sub10 3.3.3.2 Using the setting list resource
*
* Using the setting list control is the same as that of common controls.
*
* In the example application, the following code is written for creating the setting list control:
*
<div align=left><table style="width:90%;" cellspacing="4" width="90%" bgcolor="#DDDDDD" class="hcp21">
<tr>
<td style="width: 100%;"
width=100%><i class="hcp22">AknExSettingListView.cpp</i></td></tr>
<tr>
<td style="width:100%;" bgcolor="#EEEEEE" width="100%" class="hcp23">
<p class=CodeInTable>void CAknExSettingListView::HandleCommandL(
TInt aCommand )<br>
{<br>
if (EAknExSettingListCmdEmptyOutline <= aCommand)<br>
{<br>
iCurrentOutlineId = aCommand;<br>
SwapContainerL(EFalse);<br>
}<br>
<br>
switch ( aCommand ) // Command is...<br>
{<br>
...<br>
case EAknExSettingListCmdOutline03:<br>
CreateListBoxL(R_AKNEXSETTINGLIST_SETTING_LIST_SETTING_VOLUME
);<br>
break;<br>
...<br>
}<br>
} </td></tr>
</table>
</div> <br><div align=left><table style="width:90%;" cellspacing="4" width="90%" bgcolor="#DDDDDD" class="hcp21">
<tr>
<td style="width: 100%;"
width=100%><i class="hcp22">AknExSettingListView.cpp</i></td></tr>
<tr>
<td style="width:100%;" bgcolor="#EEEEEE" width="100%" class="hcp23">
<p class=CodeInTable>void CAknExSettingListView::CreateListBoxL(TInt
aResourceId)<br>
{<br>
if (iListBox)<br>
{<br>
AppUi()->RemoveFromStack(iListBox);<br>
}<br>
delete iListBox;<br>
iListBox = NULL;<br>
delete iData;<br>
iData = CAknExSettingListItemData::NewL();<br>
iListBox = new (ELeave) CAknExSettingListListbox;<br>
iListBox->SetData(iData);<br>
iListBox->SetView(this);<br>
iListBox->SetMopParent(this);<br>
iListBox->ConstructFromResourceL(aResourceId);<br>
AppUi()->AddToStackL( *this, iListBox );<br>
iListBox->MakeVisible(ETrue);<br>
iListBox->SetRect(ClientRect());<br>
iListBox->ActivateL();<br>
iListBox->DrawNow();<br>
IndicateTitlePaneTextL(iCurrentOutlineId);<br>
} </td></tr>
</table>
*
* The application programmer must be able to use the above code as is.
*
* It is necessary to define a new class derived from CAknSettingItemList for using the setting list.
*
*
<div align=left><table style="width:90%;" cellspacing="4" width="90%" bgcolor="#DDDDDD" class="hcp21">
<tr>
<td style="width: 100%;"
width=100%><i class="hcp22">Src/AknExSettingListBox.cpp</i></td></tr>
<tr>
<td style="width:100%;" bgcolor="#EEEEEE" width="100%" class="hcp23">
<p class=CodeInTable>CAknSettingItem* CAknExSettingListListbox::CreateSettingItemL(
TInt aIdentifier )<br>
{<br>
CAknSettingItem* settingItem = NULL;<br>
switch (aIdentifier)<br>
{<br>
case EAknExSettingText:<br>
settingItem = new (ELeave) CAknTextSettingItem(aIdentifier,
iData->iTextBuf);<br>
break;<br>
case EAknExSettingVolume:<br>
settingItem = new (ELeave) CAknVolumeSettingItem(aIdentifier,
iData->iVolume);<br>
break;<br>
case EAknExSettingEnumText:<br>
settingItem = new (ELeave) CAknEnumeratedTextPopupSettingItem(aIdentifier,
iData->iLanguageCode);<br>
break;<br>
...<br>
}<br>
} </td></tr>
</table>
*
*In this function, EAknExSettingVolume defined in the identifier field that is described in the previous section, is referred for instantiatiation of the target class. As described above, it is necessary to match the resource definition and controls to be created.
*
* <HR>
* \section Hierarchy_sec 4. Class Hierarchy
*
This inheritance list is sorted roughly, but not completely, alphabetically:<ul>
<li><a class="el" href="class_c_akn_ex_setting_list_app.html">CAknExSettingListApp</a>
<li><a class="el" href="class_c_akn_ex_setting_list_app_ui.html">CAknExSettingListAppUi</a>
<li><a class="el" href="class_c_akn_ex_setting_list_container.html">CAknExSettingListContainer</a>
<li><a class="el" href="class_c_akn_ex_setting_list_document.html">CAknExSettingListDocument</a>
<li><a class="el" href="class_c_akn_ex_setting_list_item_data.html">CAknExSettingListItemData</a>
<li><a class="el" href="class_c_akn_ex_setting_list_listbox.html">CAknExSettingListListbox</a>
<li><a class="el" href="class_c_akn_ex_setting_list_view.html">CAknExSettingListView</a>
*/⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -