diff -r 43e37759235e -r 51a74ef9ed63 Symbian3/SDK/Source/GUID-F3EE1000-71A6-4D48-A30B-3D2357BF20FB.dita --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/Symbian3/SDK/Source/GUID-F3EE1000-71A6-4D48-A30B-3D2357BF20FB.dita Wed Mar 31 11:11:55 2010 +0100 @@ -0,0 +1,65 @@ + + + + + +Generic +button APIThe Generic button API is used for enabling touch support for buttons. +

An Avkon button is a generic button component specifically designed for +touch support. The generic button component (CAknButton, defined in aknbutton.h) is used, for example, in +a toolbar and a status pane. The button can contain text, an image, or both.

+

Buttons can have multiple states, and each of the states can have three +different states according to user actions. The possible user-action states +for the button states are:

+ +

By default, the button has a frame, it responds to tap (press) event, has +a latchable view in the pressed-down state, and has horizontally and vertically +aligned text in it. Some default behavior can be changed with button flags +or with the help of member functions.

+

To observe the buttons in your application, use the MCoeControlObserver observer +interface.

+ +Generic button used in a toolbar + + +

The Generic button API is used for creating buttons that are displayed +as parts of container components, such as a toolbar. It is not used for creating +CBA buttons displayed in the control pane at the bottom of the device screen. +The API for creating CBA buttons is the Buttons API.

+

For look and feel guidelines on the generic button component as part of +a toolbar, see the toolbar +UI component description.

+

For information on using the API, see Enabling +touch support for buttons.

+

For the Generic button API classes and header files, see Classes and Definitions.

+
Constraints

This +API is valid for all platforms running on Symbian OS v9.3 or later.

+
Emulator support

This +API is supported in the WINS/WINSCW emulator environment, with the following +exception:

    +
  • Tactile feedback is not supported.

  • +
+
+Related APIs +Skins API + for adding skin support to the button + +Toolbar API + for creating a toolbar containing generic buttons + +Touch UI +utilities API + for using long-tap events + + +
\ No newline at end of file