Screen Design Page Properties

The property pages that display when the Screen Design page is active but none of the objects are selected are shown in these tables.

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.

Display

The Display properties shown are for the actual display area inside the device image.

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. This field is disabled if the screen being edited is a stock screen, or if the screen is associated with a mobile business object.
Assign Percentages

If this is selected then the percentages are set through 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.

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, image, list detail, choice, spacer, separator, and table because they consume the entire column regardless.

The other controls allow for customizing the alignment for the specific widget regardless of the display layout.

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.

Stock Screen Click Configure to launch the properties table, where you can customize various aspects of the stock screen. The Configure button is enabled only when the screen being edited is a stock screen.

Device

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 upto 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.
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.
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.

Mobile Business Object

The Mobile Business Object property page displays when the selected control, such as a table or 2-column list, can be associated 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 2-Column List 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 server.

Click Clear to remove the selection and update the Attributes list.

If the control is not originally associated to any MBO, all attributes of the new MBO are selected by default. Otherwise, a comparison of the previously selected attributes is against the attributes of the new MBO. If any previously selected attribute exists in the new MBO, the selection is retained.

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.

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 an MBO without selecting any of its attributes results in an unusable control and will be reported in Problems when you verify the device application.

Synchronization

Property Description
Synchronize all Mobile Business Objects on First Connection Synchronize all the mobile business objects in the device application to the device upon starting the client application for the first time.
Synchronize all Mobile Business Objects on Startup if Older Than Synchronize all the mobile business objects in the device application if the mobile business objects have not been synchronized for the defined time period.

From the drop-down list, select the time that should elapse between synchronization of the mobile business objects.

Synchronize Mobile Business Objects if Pending Operations are Greater Than or Equal Synchronize table data 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 table data should occur.

Synchronize Mobile Business Object Immediately on Delete Operations When a user performs a delete, immediately synchronize the table data.
Synchronize Progress Messages The message that will appear with the progress bar during synchronization. Select the state type from the drop-down list.

Localization

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.

Validation

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.


Created September 17, 2009. Send feedback on this help topic to Sybase Technical Publications: pubs@sybase.com