Command mapping to action buttons in the full touch UI

In the full touch UI, the header bar is displayed below the status bar and shows the title of the current view. The header bar contains placeholders for two action buttons to which Commands and IconCommands can be mapped:

Action button 1 is positioned to the right of the view title and functions as the primary action button. It displays the highest-priority positive command. You can define a custom icon for the command by using an IconCommand.
Action button 2 is positioned to the left of the view title and always shows an options icon. Selecting it opens the list of remaining commands (assuming any are available).

Figure: Action buttons in the header bar

For more information about the main elements of the full touch UI, see section Full touch devices.

Command mapping for Canvas and Form elements

The following table lists the various scenarios of how commands are mapped to the action buttons and the Back button. The scenarios only apply to commands added to Canvas or Form elements.

**Table:** Command mapping for Canvas and Form elements
Scenario	Action button 1	Action button 2 (options)	Back button
If there is only one positive command (`OK`, `ITEM`, `SCREEN`, or `HELP`).	If an icon is specified, the positive command is mapped to action button 1. Note: Any positive `IconCommand` could be mapped to action button 1. However, positive commands created as instances of `Command` cannot be mapped to action button 1. The only exception are commands of type `OK`.	If no icon is specified, the positive command is mapped to action button 2. Note: Only commands of type `OK` are mapped to action button 1 without an icon. The platform provides a tick icon by default. If there are no additional commands to display other than action button 1, action button 2 is displayed as dimmed and inactive.	The Back button is not visible.
If there is only one negative command (`STOP`, `CANCEL`, `BACK`, or `EXIT`).	Action button 1 is not visible.	If the negative command is of type `STOP`, `CANCEL`, or `EXIT`, it is mapped to action button 2.	If the negative command is of type `BACK`, it is mapped to the Back button. If there is a negative command of type `EXIT` and no command of type `BACK`, the negative command is mapped to the Back button.
If there is one negative command and one positive command.	If an icon is specified, the positive command is mapped to action button 1.	If no icon is specified, the positive command is mapped to action button 2. Negative commands (with the exception of a `BACK` command) are mapped to action button 2.	If the negative command is of type `BACK`, it is mapped to the Back button. If there is a negative command of type `EXIT` and no command of type `BACK`, the negative command is mapped to the Back button.
If more than two commands are present (positive or negative).	If an icon is specified, the highest-priority positive command is mapped to action button 1.	All other positive commands are mapped to action button 2. Negative commands (with the exception of a `BACK` command) are mapped to action button 2. For the order in which the commands are listed in the action button 2 menu, see Ordering of commands under action button 2.	If the negative command is of type `BACK`, it is mapped to the Back button. If there is a negative command of type `EXIT` and no command of type `BACK`, the negative command is mapped to the Back button.
If there is a command of type `OK` and no icon is provided.	The command is mapped to action button 1 and the default icon of a tick will be displayed.	Action button 2 is displayed as dimmed and inactive.
If there is only one action defined, the command type is not `OK`, and no icon is provided.	Action button 1 is not visible.	The command is mapped to action button 2.
If there are no additional commands to display other than action button 1 and the Back button.	Action button 1 is visible.	Action button 2 is displayed as dimmed and inactive.	The Back button is visible.

Ordering of commands under action button 2

Commands within a command list are shown in the following order:

Any STOP commands
Any OK commands
Any CANCEL commands
Any FORM ITEM commands
Any SCREEN commands
Any HELP commands
Any EXIT commands

UI element operations and item-specific commands are only accessible by a long tap. If there is more than one of any type of command, within each command type group placement, the individual commands are ordered according to the general rules specified above.