Screen Design Palette Options

Design the screen for a device application.

Controls

Option Description
Header Create a header on the screen.
Footer Create a footer on the screen (if there is no header on the screen, creating a footer automatically creates a header as well).
Label Display text.
Edit Box Enter a line of text and assign values to strings, dates, decimals, integers, and so on.
Choice Display a collection of items as a drop-down list.
Hyperlink Display a label that is underlined like a link and that can be attached to an action for screen transitions.
Checkbox Assign or display Boolean values.
Spacer Create a defined space on the screen. This allows for vertical spanning as well as horizontal spanning.
Radio Button Assign predefined options.
List Item Similar to buttons, list items are grouped in the List Group container and can have styles and actions assigned to them.
Button Trigger actions such as screen transitions.
Image You can place an image into the display as widgets (button, label, and so on). There are two types of images—one type uses the image references to display the image, the other type uses table context variables that are of image types. You can also assign actions to images.
Separator Visually isolate parts of the screen.
Table The existing table widget that displays grid data in a table.
List Detail Show property details for columns.

Containers

Option Description
Region A general purpose container that can be used to group any controls.
Radio Group A region in which to group radio buttons.
List Group A container for list items.
Tab Folder A container for tab panels.
Tab Panel Used to organize information in a tabular format. For example, you can break a long form into sections represented by tab panels. Table and List Detail controls that are related to each other can also be grouped with tab panels.

Menu

Option Description
Menu Item Performs the assigned action, for example Refresh or Synchronize.
Menu Separator Drag and drop menu separators from the Palette onto the screen menu to visually organize the menu using horizontal lines. You can use multiple menu separators, which you can move and delete. Menu separators are not tied to actions.

Actions

Option Description
Alert Alerts the user. You can create new alerts using the Alert Action dialog.
Connection Navigates to a different screen.
Note: If there are multiple actions assigned to one control or menu, the connection action must be the last action performed.
Exit Adds the exit action to the action list, which exits the client application.
Logout Logs the user out of the client.
Persist Works with user variables created in the Variable section. Allows you to save values from the screen controls or literals to set values on variables created in the Variable section when the action is performed.
Refresh Adds a refresh action to the list of actions, which refreshes the current screen based on updated data. You may want to refresh, for example, after you have synchronized a mobile business object.
Operation Enables you to create an action based on the operation of a mobile business object.
Synchronize When the action is executed, the associated mobile business object is synchronized.
Tab Activation Brings a specified tab to the front. There are three modes for the tab activation action:
  • Specific
  • Previous
  • Next

The tab activation action can wrap, which means if the current tab is the first tab, clicking the Previous tab goes to the last tab.

When the current tab is the last tab, clicking the Next tab goes to the first tab.
Save Context Adds an action to the menu so that context is maintained when navigating between screens.
BlackBerry PIM This action is available only if the selected platform for the screen is BlackBerry. Adding the BlackBerry PIM action to a control with the logical type assigned allows you to fully integrate BlackBerry applications such as calendar, address book, tasks, and memo.

Validation

Assign rule validation to the Edit Box control to validate user input.

Option Description
Rule Validation Drag and drop onto the Edit Box control to add pattern-matching rule validation. You can assign these pattern-matching datatypes:
  • Numerical
  • String
  • Date/Time
Parent topic: Device Application Designer