Buttons API: API Description

The following picture shows the visual appearance and placement of the softkeys (command buttons). The Softkey pane is not necessarily placed at the bottom of the screen, layout and orientation changes it.

A softkey cannot be instantiated directly. It is included into a CEikButtonGroupContainer class. As the button's main feature is to respond to key events the Softkey pane is added to the control stack automatically.

Use Cases

The main use cases of Buttons API are:

1. Defining resource.
2. Using CBA resource.
3. Changing text label.
4. Changing the command set via the command stack.
5. Creating ButtonGroupContainer manually.
6. Receiving command button activation event.

API Class Structure

The following diagram shows the class hierarchy of the command buttons component.