Screen Objects

The main structure for a BlackBerry device user interface is the screen object.

All screens that you create are generated into Device Application Designer screens, which extend the BaseBOBScreen class. BaseBOBScreen is the base implementation of IBOBScreen. All Device Application Designer screens implement this interface.

Users cannot change the layout of stock screens; however, they can modify certain exposed stock properties.

Device Application Designer Screen Types
Screen Type	Class	Description
Base Device Application Designer Screen	BaseBOBScreen	A base implementation of IBOBScreen that is used by most screens in the framework. It provides methods for adding menus, menu separators, and source screen references or spacers to the current screen, as well as deleting menu actions. It also creates menu items based on current focused controls.
Base Device Application Designer Stock Screen	BaseBOBStockScreen	The base Device Application Designer stock screen is used by most stock screens in the framework.
Base Device Application Designer Settings Screen	BaseSettingsScreen	The base Device Application Designer settings screen is used by most settings screens in the framework.
About Screen	AboutScreen	Information about the Sybase Unwired Platform BlackBerry client application.
Date Picker Screen	DatePickerPopup	Both shows, and allows the user to specify, date and time information.
Exception Screen	ExceptionScreen	Internal server errors.
File Explorer Screen	FileExplorerScreen	Allows the user to select a file from a device.
Image Screen	ImageScreen	Shows the entire image on the screen.
LoginScreen	LoginScreen	Login information for the Sybase Unwired Platform BlackBerry client application.
Logs Screen	LogsScreen	Logs for the Sybase Unwired Platform BlackBerry client application.
Log Information Screen	LogInfoScreen	Log information for the Sybase Unwired Platform BlackBerry client application.
Pending Operation Screen	PendingOperationScreen	Pending operations for the Sybase Unwired Platform BlackBerry client application.
Pending Operation Information Screen	PendingOperationInfoScreen	Pending operation information for the Sybase Unwired Platform BlackBerry client application.
Personalization Screen	PersonalizationScreen	Personalization information for the Sybase Unwired Platform BlackBerry client application.
Profile Screen	ProfileScreen	Profiles for the Sybase Unwired Platform BlackBerry client application.
Profile Update Screen	ProfileUpdateScreen	Profiles information for the Sybase Unwired Platform BlackBerry client application.
Push LogsScreen	PushLogsScreen	Push logs for the Sybase Unwired Platform BlackBerry client application.
Push Request Screen	PushRequestScreen	Push request for the Sybase Unwired Platform BlackBerry client application.
Push Settings Screen	PushSettingsScreen	Push settings for the Sybase Unwired Platform BlackBerry client application.
Screen Saver Screen	ScreenSaverScreen	Screen saver for the Sybase Unwired Platform BlackBerry client application.
Search Screen	SearchScreen	Search information for the Sybase Unwired Platform BlackBerry client application.
Synchronization Group Information Screen	SyncronizationGroupInfoScreen	Synchronization Group information for the Sybase Unwired Platform BlackBerry client application.
Synchronization Screen	SynchronizationScreen	Synchronization information for the Sybase Unwired Platform BlackBerry client application.

Example 1

This example illustrates how to customize stock/settings screen properties:

//Define and register the screen
screen5 = new AboutScreen("About", "untitled1");

//Section to define the stock screen properties
screen5.setProperty(ABOUT_SCREEN_LOGO_IMAGE, "blackberry_16.gif");
screen5.setProperty(ABOUT_SCREEN_VERSION_LABEL, "MyVersion");