diff -r 000000000000 -r 89d6a7a84779 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 Thu Jan 21 18:18:20 2010 +0000 @@ -0,0 +1,50 @@ + + + + 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 9.3 or later.

+
Emulator support

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

    +
  • Tactile feedback is not supported.

  • +
+
\ No newline at end of file