Control Objects

Control objects represent all of the user interface (UI) components on the Device Application Designer screens, which are rectangular regions that a Manager controls. A control's layout requirements determine the control size. Managers provide scrolling for the fields that they contain.

Device Application Designer Control Types
Control Type	Class	Description
Button	Button	Extends Field and displays the assigned text or image. You can set a focus on a button control; thus, you can assign different styles to it for focused and unfocused. You can also bind a button to a list of actions, which run when the trackball is clicked or touched on touchable devices.
Cell Image	CellImage	Extends ImageControl. You can bind CellImage to a MBO attribute, value mapping, state indicator, variable, or image.
Cell Label	CellLabel	Extends Label. You can assign styles to it for focus and unfocus status. You can bind CellLabel to MBO attributes, literals, or variables.
Cell Table	CellTable	Extends ListField and displays the data of the assigned MBO. Cell table accommodates cell labels and cell images, which can be bound to MBO attributes. In addition, cell image can be configured to show a different image based on the specified attribute’s value. You can assign styles to cell table for focus and unfocus status. You can bind CellTable to a MBO, whose values are filled into the table.
Check Box	CheckBox	Extends CheckboxField.
Grid Table	MobileAppTable	Extends Field and displays the data of the assigned MBO. The table header displays the MBO attributes, while the cells display the corresponding value. Styles can be assigned to Mobile App table for header, odd row, even row, pending row, border, focused cell. You must bind MobileAppTable to a MBO, for which the values are filled into the table.
Horizontal Ruler	HorizontalRuler	Draws a line across the screen.
Hyperlink	HyperLink	Extends LabelField and displays the assigned text with underscore. You can set a focus on a hyperlink control; thus, you can assign different styles to it for focused and unfocused. You can also bind Hyperlink to a list of actions, which run when the trackball is clicked or touched on touchable devices.
Hyperlink Rich Field	HyperLinkRichField	The difference between HyperLinkRichField and HyperLink is that HyperLinkRichField uses Blackberry rich context matching to handle phone and email options.
Image Control	ImageControl	Extends BitmapField and displays the assigned image. You can bind ImageControl to a list of actions, which run when the trackball is clicked or touched on touchable devices.
Label	Label	Extends LabelField and displays the assigned text.
List Detail	TwoColumnLayout	Extends LayoutManager, must be bound to a MBO, and can display the details for the assigned MBO in a two column layout. As with MobileAppTable, odd row style, even row style, pending style, border style, and focus style are available. You can assign hot keys as well as menu labels to previous/next menus of this control.
List Item	ListFieldControl	Extends ListField and displays the assigned text or image. You can set a focus on a list item control; thus, you can assign different styles to it for focused and unfocused. You can also bind a list item to a list of actions, which run when the trackball is clicked or touched on touchable devices.
Navigation Bar	NavigationBar	Extends BitmapField and allows users to navigate client screens and keep track of where they are.
Radio Box	RadioBox	Extends RadioButtonField and displays the assigned text. RadioBox is contained in the RadioBoxGroup.
Select Box	SelectBox	Extends ObjectChoiceField and displays the assigned texts. You can bind SelectBox to a MBO, whose values are filled into the select box.
Spacer	Spacer	Extends Field and shows nothing.
Text Input	TextInput	Extends EditField and displays the assigned texts. You must assign a data type to TextInput, the default type is STRING. You can also assign it a logical type for personal information management (PIM). Validations are also available.
Toolbar Item	Toolbar Item	Extends Button control. You must add it to Toolbar. Toolbar Item is only available on touch screen devices. Toolbar item can be assigned image and actions.

Example 1

This example illustrates how to create a control:

CellImage cellImage = new CellImage(Field.FIELD_LEFT
| Field.FIELD_VCENTER);

    CellLabel cellLabel = new CellLabel(Field.FIELD_LEFT
| Field.FIELD_VCENTER);

CellTable cellTable = new CellTable(Field.FIELD_LEFT);

This example illustrates how to configure a control:

CellTable localcellTable1 = (CellTable) object;
//Create set of submit elements 
Vector submit1 = new Vector();
submit1.addElement(new SubmitElement("parameter1",
		"2010-06-07", VariableProperties.SUBMIT_USER_TYPE,
		null, false, null, -1, "startDate",
		MBOAttribute.SCHEMA_TYPE_DATE, false, null, false));
localcellTable1.setColumnPercentage(new int[] { 10, 60, 30 });
localcellTable1.setSortingColumn("Sort on column");
localcellTable1.setMboId(BOBCUIDefinition.MBO_POC_ACTIVITY);
localcellTable1.setNamedQuerySubmitElements(submit1);
localcellTable1.setNamedQuery("findByDate");
localcellTable1.setFocusFontStyle(styleCell_Table_Focus_Style);
localcellTable1.setNumberOfColumns(3);
localcellTable1.setColumnConfig(new String[] { "description",
		"status", "actType" });
localcellTable1
		.setUnfocusFontStyle(styleCell_Table_Unfocus_Style);

CellImage localcellImage0 = (CellImage) object;
localcellImage0
		.setImageType(ICellAttributeTypeConstants.IMAGE_VALUEMAPPING_TYPE);
localcellImage0.setPreserveAspectRatio(true);
localcellImage0.setOrder(0);
localcellImage0.setMboAttrId("typeCode");