These are the property pages that display in the Properties for the Screen Design page when no objects are selected.
The default values for the properties shown are determined by the Device Application Designer preferences. Right-click in any page (except the Introduction page) of the Device Application Designer and select Preferences.
The Display properties shown are for the actual display area inside the device image. The Display page has three tabs—Definition, Platform-specific, and Coding.
| Property | Description |
|---|---|
| Number of columns | The number of columns in the display. Only 1-column, 2-column and 3-column are supported. The default is 2-column. |
| Assign percentages |
Select to set the percentages of the spinner controls. There is a spinner control for each column. The numbers restrict the size to a minimum of 10 and a maximum of 90 on a 2-column display and 80 on a 3-column display. The percent values are always set to equal 100% so that the columns in the display are aligned by these percentages. |
| Horizontal alignment | Pick the alignment default for all
objects in the screen display. This aligns the objects to the point in the column
corresponding to the choice. Note: Some controls ignore alignment ; for example, edit box, list item, toolbar item, image, list detail, choice,
spacer, separator, and table because they occupy the entire column regardless of the display layout.
The other controls allow for customizing the alignment for the specific widget regardless of the display layout. |
| Show pattern | Select to show a pattern in the background. |
| Background image | Click Browse to choose an image to display in the background. |
| Scale image to fill display size | Select to scale the image to fill the display size. If this is not selected, the image fits the fixed aspect. |
| Style | Select the style of
the display. Click Search to search available styles. Click Edit to edit the selected style. Click Restore to restore the default style. |
The Platform-specific tab displays only the properties that are platform-specific. The property values displayed in the Platform-specific tab can be read-only or configurable.
The Coding tab is displayed for controls and containers that support events. Events allow you to specify custom events on screens and screen controls during design time. For example, a table of e-mails can display records differently (maybe with an icon for unread mail) depending on the state of the e-mail.
| Property | Description |
|---|---|
| ID | The internal ID of the control. This is a read-only field for informational purposes. Not all controls have IDs. This is left blank for controls that do not have an ID. |
| Base name | An optional name for the control, for example, SubmitButton. This name can be empty, but if specified, it must be unique within a screen. This name is not localizable. Only alphanumeric (a-z, A-Z, 0-9) and underscores (_) are allowed in the name. |
| Events | Lists the available events for the selected control. The list of events varies according to the type of control selected. Select the events to customize by selecting one or more of the checkboxes. |
This tab is displayed in the screen properties if the selected screen is either a stock or settings screen. The properties are displayed in a table. Select a property and click Configure to configure individual properties.
Select a property and click Restore to restore the selected property to its default settings.
Select a property and click Restore All to restore all properties to their default settings.
If you are viewing the Properties for a BlackBerry Custom Code stock screen, you see a Create Screen Class button. Click this button to create a Java class for the BlackBerry custom screen.
| Property | Description |
|---|---|
| Platform device | Select the platform from the first drop-down list and the device from the second drop-down list. The Platform determines the features available in the Device Application Designer, and the Device determines the Screen Design look and feel. |
| Device ribbon name | The name of the mobile application ribbon that appears on the device home screen. |
| Device ribbon image | The icon you select to appear on the device home screen. Clicking on the icon starts the application with which it is associated. |
| Device database page size | When the device database reads or writes data it works with fixed
blocks of data called pages. When the page size is increased, the size of the block of data that is read or written in one operation is increased, which reduces the need to access flash memory. The default page size is 4k, which is appropriate in most cases. Note: If there is data that is more than 4k in a single row on the device, you must increase the page size to accommodate the data. The UltraLite database supports a page size of up to 32k. For this setting to work correctly, you must choose a database page size that is supported by both the underlying database and the device itself. Otherwise, you may get file I/O failed exception and the application exits.
|
| Device database cache size | When the device database reads or writes data it works with fixed blocks of data called pages. When the cache size is increased, the number of pages that are cached for operations is increased, which reduces the need to access flash memory. The default cache size is 128k. Note: For this setting to work correctly, you must choose a database cache size that is supported by both the underlying database and the device itself. Otherwise, you may get file I/O failed exception and the application exits.
|
| Show millisecond on time selection | If this option is selected, the DATETIME and TIME data types use the millisecond version on the device and in the Device Application Designer. |
The platform-specific tab displays only the properties that are platform-specific. The property values displayed in the Platform-specific tab can be read-only or configurable.
| Property | Description |
|---|---|
| Synchronize all synchronization groups on first connection | Synchronize all synchronization groups with their mobile business objects in the device application to the device when starting the client application for the first time. |
| Synchronize all synchronization groups on startup if older than | Synchronize all the synchronization groups in the device application if the synchronization groups have not been synchronized for the defined time period. Input the time period number in the editbox, and select the time period type (minute, hour or day) from the drop-down list. |
| Synchronize synchronization groups if pending operations are greater than or equal to | Synchronize the synchronization groups if the number of pending operations equals or exceeds the number selected. From the drop-down list, select the maximum number of pending operations before synchronization of the synchronization groups should occur. |
| Synchronize synchronization group immediately on delete operations | When a user performs a delete, immediately synchronize the synchronization group. |
| Synchronize progress messages | The message that appears with the progress bar during synchronization. Select the state type from the drop-down list, and type the message in the editbox. |
The Mobile Business Object property page displays when the selected control, such as a grid table, cell table, or list detail can be bound to a mobile business object. Use this page to associate a mobile business object to the selected control and configure the attributes to be displayed in the control. For example, you can associate a Customer List MBO to a Table control, and choose to show the First name, Last name, and Phone number of the customers. You can also associate the same MBO to another list detail control and choose to show all the attributes of a customer.
| Property | Description |
|---|---|
| Mobile business object | The MBO associated with the control. Click Search to browse the available mobile business objects in the mobile application projects. Click Clear to remove the selection and update the Attributes list. If the control is not originally associated with an MBO, the first four attributes of the new MBO are selected by default. Otherwise, a comparison of the previously selected attributes is performed against the attributes of the new MBO. If any previously selected attribute exists in the new MBO, the selection is retained. |
| Object query | Select to apply the object query to the data shown in the control. The object query drop-down shows the queries available for the selected MBO. If there are parameters in the query, the Initial Parameter Values button is enabled. Click Initial Parameter Values to launch the Initial Object Query Parameters configuration dialog. |
| Attributes | This lists all the attributes in the MBO. Drag and drop items up and down to reorder the attributes list. Only selected attributes can be ordered.
This property does not appear if the control the MBO is bound to is a cell table because cell tables can use an attribute more than once. Click Edit Attributes to edit the MBO attributes. Click Select All to select all the attributes and Deselect All to the clear all the selections. Note: Linking a control to a mobile business object without selecting any of its attributes results in an unusable control and is reported in the Problems view when you verify the device application.
|
| Error message | Enter the error message that the user sees when there is an error loading the mobile business object. |
The table displays the default locale and other available locales. This table describes the actions you can perform by clicking any of the buttons on the right.
| Button | Description |
|---|---|
| New | Create a new locale. |
| Update | Update the current locale. |
| Load | Load the selected locale. |
| Validate | Validate the selected locale. |
| Edit | Edit the selected locale. |
| Remove | Remove the selected locale. |
The Validation tab displays only when viewing the Properties page for an Edit Box control.
| Button | Description |
|---|---|
| New | Create a new rule validation item for the edit box. Newly created validation items appear in the table. You can order the validation items in the list by dragging and dropping. |
| Edit | Edit the selected validation item. |
| Remove | Remove the selected validation item. |