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.
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. |
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);
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");