Week 23 contribution of SDK documentation content. See release notes for details. Fixes bugs Bug 2714, Bug 462.
<?xml version="1.0" encoding="utf-8"?>
<!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->
<!-- This component and the accompanying materials are made available under the terms of the License
"Eclipse Public License v1.0" which accompanies this distribution,
and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->
<!-- Initial Contributors:
Nokia Corporation - initial contribution.
Contributors:
-->
<!DOCTYPE concept
PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
<concept id="GUID-CCE6DC36-625C-487C-9AD8-F1BF8E36080A" xml:lang="en"><title>UI components</title><prolog><metadata><keywords/></metadata></prolog><conbody>
<p><draft-comment time="2010-03-04T16:19" translate="no">This table has been filtered for
PDK, SDK and Internal publications. The conditions applied for each row can
be viewed in the Document Map on the left hand pane (they have attribute mark).</draft-comment></p>
<table id="GUID-CB1618F8-C658-42A5-BF86-3AA8CDCFF681-GENID-1-10-1-6-1-1-5-1-2-2">
<tgroup cols="3"><colspec colname="col1" colwidth="0.82*"/><colspec colname="col2" colwidth="1.45*"/><colspec colname="col3" colwidth="0.73*"/>
<thead>
<row>
<entry> <p>Component</p> </entry>
<entry> <p>Example image</p> </entry>
<entry> <p>C++ APIs for implementation</p> </entry>
</row>
</thead>
<tbody>
<row>
<entry> <p> <xref href="GUID-EB212C35-5416-4CA7-8091-61B45D78E220.dita">Toolbar</xref></p>
</entry>
<entry> <fig id="GUID-CD41B544-521C-4271-A7D8-1C68399AB3A6">
<image href="GUID-2A4DED23-D0AB-436A-BCED-F0645FF05726_d0e51533_href.png" placement="inline"/>
</fig> </entry>
<entry> <p><xref href="GUID-B05B61B8-1217-441F-BAFA-C209C8F123C5.dita">Toolbar
API</xref>, <xref href="GUID-F3EE1000-71A6-4D48-A30B-3D2357BF20FB.dita">Generic
button API</xref> for buttons</p> </entry>
</row>
<row>
<entry><p><xref href="GUID-CCC5BE18-E90D-4B81-AE6F-333B96E7A3F7.dita">Choice list</xref></p></entry>
<entry><fig id="GUID-EAE34488-B88B-4D2C-9DAB-A5D8C2AFDE4C">
<image href="GUID-7A2A9222-7D10-4007-95AB-C9584EC54698_d0e51559_href.png" placement="inline"/>
</fig></entry>
<entry><p><xref href="GUID-C29FE12C-C412-40A8-A067-27C63A519D71.dita">Choice list
API</xref></p></entry>
</row>
<row>
<entry> <p><xref href="GUID-1AA32C40-CDE0-4627-A634-7C07BB1ED67B.dita">Forms</xref></p>
</entry>
<entry> <fig id="GUID-F0BF6AEC-5F2D-4BFC-98B4-E8E934FCE10C">
<image href="GUID-11A79174-485E-425C-9653-193B670A3F03_d0e51581_href.png" placement="inline"/>
</fig> </entry>
<entry> <p><xref format="html" href="specs/guides/Form_API_Specification/Form_API_Specification.html" scope="peer">Form API</xref></p> </entry>
</row>
<row>
<entry> <p><xref href="GUID-A5756C5F-9C93-4949-8B60-03DCA1BAF683.dita">Form
items</xref></p> <ul>
<li><p>Text field</p> </li>
<li><p>Pop-up field</p> </li>
<li><p>Slider</p> </li>
</ul> </entry>
<entry><fig id="GUID-65FDE0EB-6063-475D-BC7A-CF0D53445009">
<image href="GUID-DC4E42CA-2A65-44D7-8DBE-386F60F998A0_d0e51623_href.png" scale="27" placement="inline"/>
</fig></entry>
<entry> <p><xref format="html" href="specs/guides/Form_API_Specification/Form_API_Specification.html" scope="peer">Form API</xref></p> </entry>
</row>
<row>
<entry> <p><xref href="GUID-40F5B725-A5D7-487F-BF5D-A616F768F40D.dita">Grouped
soft notification</xref>, <xref href="GUID-13DEE42F-3EAB-4EB7-9CE1-C4930BCACE01.dita">List
query</xref>, <xref href="GUID-434F2412-59A1-4BCB-885D-5E708EAA6AB6.dita">Grid
query</xref></p> </entry>
<entry> <fig id="GUID-0FF4831E-1870-40B0-8F29-A6F14826412E">
<image href="GUID-81767E3E-BE4D-40D9-A4F2-3801BCCC1EA7_d0e51653_href.png" placement="inline"/>
</fig> </entry>
<entry> <p>Queries API</p> </entry>
</row>
<row>
<entry> <p>Left/Right arrows in the <xref href="GUID-76FD2A71-E8A3-4C82-9704-3F7F6AD4DFD8.dita">Navi
pane</xref></p> </entry>
<entry> <fig id="GUID-DD17310A-C196-4DC6-82EB-D328B81628F5">
<image href="GUID-EDBCCC26-BA4D-4318-9F0D-62272FA97BBF_d0e51678_href.png" placement="inline"/>
</fig> </entry>
<entry> <p><xref format="html" href="specs/guides/Navigation_Pane_API_Specification/Navigation_Pane_API_Specification.html" scope="peer">Navigation pane API</xref></p> </entry>
</row>
<row>
<entry> <p><xref href="GUID-ED784025-4E65-4BE9-ADA8-A13427B6EA30.dita">Markable
list</xref></p> <p><xref href="GUID-0822B030-E776-4BD5-B9C9-23D3821BCE1F.dita">Selection
list</xref></p> </entry>
<entry> <fig id="GUID-766A6391-9572-4231-8756-8ACDB5EED335">
<image href="GUID-8CCA308A-5302-4D95-8E60-DA75D8B6DC41_d0e51707_href.png" placement="inline"/>
</fig> </entry>
<entry> <p><xref format="html" href="specs/guides/Lists_API_Specification/Lists_API_Specification.html" scope="peer">Lists API</xref></p> </entry>
</row>
<row>
<entry> <p><xref href="GUID-0E695106-4139-4335-A11F-BD04418DD583.dita">Multi-selection
list</xref></p> </entry>
<entry> <fig id="GUID-E899EFED-C4E7-45A3-B262-A5D3DFFB96BC">
<image href="GUID-3AA34D0C-539D-4D4E-9337-EB5B83AEF4C1_d0e51732_href.png" placement="inline"/>
</fig> </entry>
<entry> <p><xref format="html" href="specs/guides/Lists_API_Specification/Lists_API_Specification.html" scope="peer">Lists API</xref></p> </entry>
</row>
<row>
<entry> <p><xref href="GUID-11C24609-3B6D-4B44-B003-FB0C07444A9E.dita">Scrollbar</xref></p>
</entry>
<entry><fig id="GUID-3123A8A3-1DEF-4DA2-8A55-9D4FD0966D8A">
<image href="GUID-3382507E-1B21-418C-A908-DD3F688C0672_d0e51756_href.png" placement="inline"/>
</fig></entry>
<entry><p><xref format="html" href="specs/guides/Scroller_API_Specification/Scroller_API_Specification.html" scope="peer">Scroller API</xref></p></entry>
</row>
<row>
<entry> <p><b>Setting items</b></p> </entry>
<entry/>
<entry><p><xref format="html" href="specs/guides/Setting_Pages_API_Specification/Setting_Pages_API_Specification.html" scope="peer">Setting pages API</xref></p></entry>
</row>
<row>
<entry> <p>Pop-up setting</p> </entry>
<entry><fig id="GUID-B2C37310-2E83-44A9-BDE8-28C273C89152">
<image href="GUID-DFBBA71F-0042-4303-B66F-0D291106B655_d0e51793_href.png" placement="inline"/>
</fig></entry>
<entry> <p/> </entry>
</row>
<row>
<entry> <p>Multi-selection list setting</p> </entry>
<entry><fig id="GUID-B9E2C260-5278-4C2E-B76C-17305547F324">
<image href="GUID-3AA34D0C-539D-4D4E-9337-EB5B83AEF4C1_d0e51813_href.png" placement="inline"/>
</fig></entry>
<entry> <p/> </entry>
</row>
<row>
<entry><p><xref href="GUID-B452DBD8-F9EB-4DAB-9D0C-3B11D7C360F4.dita">Text setting</xref></p></entry>
<entry><fig id="GUID-C9E90E52-534A-41FE-A4E0-5DD39ADB8C1A">
<image href="GUID-F161C184-2016-4331-A57C-78C753453EFE_d0e51832_href.png" placement="inline"/>
</fig></entry>
<entry> <p/> </entry>
</row>
<row>
<entry><p><xref href="GUID-1BDADA7A-D517-49F4-AF46-AFC2B7758571.dita">Slider setting</xref></p></entry>
<entry><fig id="GUID-6EAC8628-057C-4164-A6E9-D01BF6326276">
<image href="GUID-D8D65830-CC9D-4E9F-A206-34BB077E89E6_d0e51851_href.png" placement="inline"/>
</fig></entry>
<entry> <p/> </entry>
</row>
<row>
<entry> <p><xref href="GUID-F149726A-CC79-42A1-8A25-E15AC14ABE9A.dita">Setting
list</xref></p> </entry>
<entry> <fig id="GUID-8331EB35-DA07-4A91-B5E4-63246039FE91">
<image href="GUID-EC7E0C0E-EEB0-45B5-BE4A-11CAF78EC366_d0e51873_href.png" placement="inline"/>
</fig> </entry>
<entry> <p><xref format="html" href="specs/guides/Setting_Pages_API_Specification/Setting_Pages_API_Specification.html" scope="peer">Setting pages API</xref>, <xref format="html" href="specs/guides/Lists_API_Specification/Lists_API_Specification.html" scope="peer">Lists API</xref></p> </entry>
</row>
<row>
<entry> <p>Softkeys (left and right) in the <xref href="GUID-8B137691-7C9E-4085-BFFE-4CFE4A64A091.dita">Control
pane</xref></p> <note>There is no middle softkey label in Touch
UI</note> </entry>
<entry> <fig id="GUID-9EE9B343-0FA2-4A7B-A302-21D16DE078EA">
<image href="GUID-A0208BE3-127F-4D04-8045-09C54EF202DD_d0e51905_href.png" placement="inline"/>
</fig> </entry>
<entry> <p><xref format="html" href="specs/guides/Buttons_API_Specification/Buttons_API_Specification.html" scope="peer">Buttons API</xref></p> </entry>
</row>
<row>
<entry> <p><xref href="GUID-771AF721-E2D7-41C8-BF97-5BD30D1A28AD.dita">Status
pane</xref></p> <ul>
<li> <p><xref href="GUID-66EFFCF5-581A-4EE7-B784-8087A1081B6D.dita">Title
pane</xref></p> </li>
<li> <p><xref href="GUID-76FD2A71-E8A3-4C82-9704-3F7F6AD4DFD8.dita">Navi
pane</xref></p> </li>
<li> <p><xref href="GUID-A947B5A8-9138-4FA2-B8D8-2850AEB2F38C.dita">Battery
pane</xref></p> </li>
<li> <p><xref href="GUID-314B1556-5CB5-4BCC-93C0-B22DB849D2D5.dita">Universal
indicator pane</xref></p> </li>
<li> <p><xref href="GUID-DF3F2FD0-FF68-4CEF-843F-CBC9E84F3A7F.dita">Signal
pane</xref></p> </li>
<li><p><xref href="GUID-CA2AACD9-A99D-4C34-80AF-C1B61AC9331F.dita">Clock Pane</xref></p></li>
</ul> </entry>
<entry> <fig id="GUID-A9181E38-4478-4705-8F63-1B0B209899B3">
<image href="GUID-D9F3D83E-50C7-4D15-839C-F225D95865B0_d0e51973_href.png" placement="inline"/>
</fig> </entry>
<entry> <ul>
<li><p><xref format="html" href="specs/guides/Status_Pane_API_Specification/Status_Pane_API_Specification.html" scope="peer">Status pane API</xref> for the entire status pane</p></li>
<li><p>Title pane API for the title pane</p></li>
<li><p>Title Pane Touch Observer API for title pane touch events</p></li>
<li><p><xref format="html" href="specs/guides/Navigation_Pane_API_Specification/Navigation_Pane_API_Specification.html" scope="peer">Navigation pane API</xref> for the entire navi pane</p></li>
<li><p><xref format="html" href="specs/guides/Tabs_API_Specification/Tabs_API_Specification.html" scope="peer">Tabs API</xref> for tabs in the navi pane</p></li>
<li><p>HWRM power state API for a publish and subscribe interface to battery
status</p></li>
<li><p>Indicators API for the indicator pane</p></li>
<li><p>The signal pane is not accessible to applications.</p></li>
</ul> </entry>
</row>
</tbody>
</tgroup>
</table>
<p>For details on touch support of these components, see <xref href="GUID-BB8B3A11-0BBC-4759-A7F4-A28C9E70573F.dita">Touch
support for UI components</xref></p>
</conbody></concept>