diff -r 51a74ef9ed63 -r ae94777fff8f Symbian3/SDK/Source/GUID-F3EE1000-71A6-4D48-A30B-3D2357BF20FB.dita --- a/Symbian3/SDK/Source/GUID-F3EE1000-71A6-4D48-A30B-3D2357BF20FB.dita Wed Mar 31 11:11:55 2010 +0100 +++ b/Symbian3/SDK/Source/GUID-F3EE1000-71A6-4D48-A30B-3D2357BF20FB.dita Fri Jun 11 12:39:03 2010 +0100 @@ -1,65 +1,67 @@ - - - - - -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 - - + + + + + +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:

+
    +
  • Normal

  • +
  • Pressed down

  • +
  • Dimmed

  • +
+

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.

+
Changes and release information

The Generic button +API is an SDK API and first released in S60 5th Edition.

+
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