diff -r 43e37759235e -r 51a74ef9ed63 Symbian3/SDK/Source/GUID-8B137691-7C9E-4085-BFFE-4CFE4A64A091.dita --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/Symbian3/SDK/Source/GUID-8B137691-7C9E-4085-BFFE-4CFE4A64A091.dita Wed Mar 31 11:11:55 2010 +0100 @@ -0,0 +1,50 @@ + + + + + +Control +pane +

The Control pane occupies the bottom part of the screen and displays the +labels associated with the softkeys.

+ +Control pane + + +

Normal touch down and release functionality applies to the softkeys in +control pane. Activation is performed on touch release. However, activation +can be cancelled by dragging the touch from the softkey area and performing +a touch release.

+

The Control pane is also active during Options +menus, queries, +and other states using pop-up +windows, although it does not itself reside in a pop-up window.

+

The actual physical softkeys should be positioned directly beneath the +screen so that the association between the keys and their respective labels +is evident. Note, however, that the middle label refers to the Selection key +(see Labeling the Selection +key for further details).

+
Using +the control pane in C++ applications

The APIs to use for the control +pane are the Buttons API for the softkeys and the Options menu API for the menus.

For implementation +information on using the softkeys, see Using the Buttons API. For implementation information +on the menus, see Using the Options menu API.

The Symbian +platform uses Control Button Area (CBA) resources to set the options in the +control pane above the softkeys. CBA resources map the text that appears above +the softkeys in the control pane with commands that are collected by the event +loop of the application framework and delivered to your application for command handling.

When +a mobile device user selects an Options softkey, the application framework +displays the Options menu based upon the definitions in the menu bar's resources.

The +Symbian platform uses MENU_BAR resources to create the Options menu, when +a mobile device user selects the Options softkey. The options that appear +above the softkeys are determined by CBA resources. The MENU_BAR resources +map the text that appears in the Options menu with commands that are collected +by the event loop of the application framework and delivered to your application +for command handling.

+
\ No newline at end of file