<?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>