<?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-97712509-84AD-462F-8FFB-E1E6D8278938" xml:lang="en"><title>Enabling
touch support for buttons</title><prolog><metadata><keywords/></metadata></prolog><conbody>
<p>To use a touch-enabled button in your application, implement the following
use cases:</p>
<ul>
<li><p><xref href="GUID-CDBBD44F-C5F6-4D51-B4BA-23DA9BB58D69.dita">Creating generic
button</xref></p></li>
<li><p><xref href="GUID-96C49728-8C78-4D82-876D-6B1196362D44.dita">Setting button
properties not specific to any state</xref></p></li>
<li><p><xref href="GUID-07DD47FD-86B7-4AFD-BEDB-DF6EA12DFC6C.dita">Using button
states</xref></p></li>
<li><p><xref href="GUID-089FE9FA-44C8-48D5-A473-9486BF763283.dita">Setting properties
for button states</xref></p></li>
<li><p><xref href="GUID-E1A2872E-6E8D-4C02-B3C0-23213FD56106.dita">Handling button
events</xref></p></li>
</ul>
<p><draft-comment time="2008-05-12T14:05" translate="no">We need to provide more clarity
on the required order of implementing the use cases and clarify whether there
are alternative approaches for achieving the same results.</draft-comment></p>
<p>The following use cases are optional, allowing you to set additional properties
for your button:</p>
<ul>
<li><p><xref href="GUID-62DF565C-8121-429F-99D0-B5FBDE634AA9.dita">Using long-tap
events</xref></p></li>
<li><p><xref href="GUID-79B4468A-2CF6-45E2-BC05-064CA300C12C.dita">Using skin support
in buttons</xref></p></li>
</ul>
<section><title>Implementation file</title><p>The implementation file for
the Generic button API is <xref href="jar:GUID-759FBC7F-5384-4487-8457-A8D4B76F6AA6.jar!/html/aknbutton_8h-source.html" format="application/java-archive"><codeph>aknbutton.h</codeph></xref>.</p></section>
</conbody><related-links>
<link href="GUID-F3EE1000-71A6-4D48-A30B-3D2357BF20FB.dita"><linktext>Generic button
API description</linktext></link>
<link href="GUID-EB212C35-5416-4CA7-8091-61B45D78E220.dita"><linktext>Look and
feel guidelines for the generic button in a toolbar</linktext></link>
</related-links></concept>