Development Guide

Local Navigation

• UI
  • Types of UI APIs
    • BlackBerry UI APIs
    • MIDP APIs
    • SVG APIs
    • Graphics Utility API
  • Advantages of BlackBerry UI APIs
  • Creating a UI that is consistent with standard BlackBerry UIs
• Fundamental UI components
  • Fields
    • Box model
      • Padding
      • Border
      • Margin
      • Determining the dimensions of a field
  • Managers
    • Vertical field manager
    • Horizontal field manager
    • Flow field manager
  • Screens
    • Screen classes
    • Developing applications for different screen sizes
• Drawing directly on a screen
  • Context stack
  • Drawing shapes
  • Draw shapes on the screen
    • Code sample: Drawing shapes on the screen
• UI life cycle
  • Starting
  • Running
  • Terminating
  • Event thread
  • Event lock
  • Create the framework for applications with a UI
    • Code sample: Creating the framework for applications with a UI
  • Override layout()
    • Code sample: Overriding layout()
  • Best practice: Reducing the number of layouts
  • Override paint()
    • Code sample: Overriding paint()
  • Optimizing painting
    • Using strings effectively
    • Using bitmaps effectively
    • Using fonts effectively
    • Caching the dimensions of a field
• UI components
  • Add a UI component to a screen
  • Aligning a field to a line of text
  • Buttons
    • Best practice: Implementing buttons
    • Create a button
  • Check boxes
    • Best practice: Implementing check boxes
    • Create a check box
      • Code sample: Creating a check box
  • Create a bitmap
  • Create a custom field
  • Creating a field to display web content
    • Display HTML content in a browser field
      • Code sample: Displaying HTML content in a browser field
    • Display HTML content from a web page in a browser field
      • Code sample: Displaying HTML content from a web page in a browser field
    • Display HTML content from a resource in your application
      • Code sample: Displaying HTML content from a resource in your application
    • Configure a browser field
      • Code sample: Configuring a browser field
    • Send form data to a web address in a browser field
      • Code sample: Sending form data to a web address in a browser field
  • Dialog boxes
    • Best practice: Implementing dialog boxes
    • Create a dialog box
  • Drop-down lists
    • Best practice: Implementing drop-down lists
    • Create a drop-down list
      • Code sample: Creating a drop-down list
  • Labels
    • Best practice: Implementing labels
    • Create a text label
  • Lists and tables
    • Best practice: Implementing lists and tables
    • Create a list box
  • Radio buttons
    • Best practice: Implementing radio buttons
    • Create a radio button
      • Code sample: Creating a radio button
  • Activity indicators and progress indicators
    • Best practice: Implementing activity indicators and progress indicators
    • Indicating activity or task progress
      • Indicate activity
      • Indicate progress
  • Pickers
    • Best practice: Implementing pickers
    • Create a date picker
    • Create a file picker
      • Code sample: Creating a file picker
  • Search
    • Best practice: Implementing search
    • Create a search field
    • Autocomplete text field
      • Create an autocomplete text field from a data set
      • Create an autocomplete text field from a data source
      • Using data sources and fields with an autocomplete text field
  • Spin boxes
    • Create a spin box
    • Best practice: Implementing spin boxes
  • Text fields
    • Best practice: Implementing text fields
    • Creating a text field
      • Create a read-only text field that allows formatting
      • Create an editable text field that has no formatting and accepts filters
      • Create an editable text field that allows special characters
      • Create a text field for AutoText
    • Create a date field
    • Create a password field
  • Tree views
    • Best practice: Implementing tree views
    • Create a field to display a tree view
• Events
  • Using listeners
  • Add a generic listener for a field
    • Code sample: Adding a generic listener for a field
  • Add a custom listener for a field
    • Code sample: Adding a custom listener for a field
• Command Framework API
  • Use a command with one UI component
  • Use a command in one or more applications
• Arranging UI components
  • Arrange UI components
  • Creating a grid layout
    • Create a grid layout
      • Code sample: Creating a grid layout
  • Displaying a field at an absolute position on a screen
    • Display a label at an absolute position on the screen
    • Code sample: Displaying a label at an absolute position on the screen
  • Displaying fields on a temporary pair of managers
    • Display a ButtonField and a LabelField temporarily on the top and bottom of the screen
      • Code sample: Displaying a ButtonField and a LabelField temporarily on the top and bottom of the screen
• Advanced UI components and managers
  • About the advanced UI library
  • Creating a button field set
    • Create a button field set
  • Creating a list style button field
    • Create a list style button field
  • Creating a list style button set
    • Create a list style button set
  • Creating a pill button set
    • Create a pill button set
  • Creating a bitmap progress indicator
    • Create a bitmap progress indicator
  • Creating a labeled switch
    • Create a labeled switch
  • Creating a slider
    • Create a slider
  • Creating a negative margin
    • Create a negative margin
• Menu items
  • Create a menu
    • Code sample: Creating a menu
  • Best practice: Implementing menus
  • Submenus
    • Best practice: Implementing submenus
    • Create a submenu
    • Code sample: Creating a submenu
  • Pop-up menus
    • Best practice: Implementing pop-up menus
    • About placing items in the pop-up menus
    • Support for legacy context menus
    • Creating a pop-up menu
      • Create a pop-up menu
      • Code sample: Creating a pop-up menu
  • Adding a menu item to a BlackBerry Device Software application
    • Add a menu item to a BlackBerry Device Software application
  • Changing the appearance of a menu
    • Change the appearance of a menu
    • Code sample: Changing the appearance of a menu
• Fonts
  • Measuring text
  • Use a font in your application
    • Code sample: Using fonts in your application
  • Deriving fonts
    • Derive a font
      • Code sample: Deriving a font
  • Custom fonts
    • Install and use a custom font in a BlackBerry Java application
    • Code sample: Installing and using a custom font in a BlackBerry Java application
• Spelling checker
  • Add spell check functionality
  • Listen for a spell check event
• Barcode scanning
  • Barcode types supported
  • Create a barcode scanner
    • Code sample: scan a barcode
  • Hints
    • Add a hint to your barcode scanner
• BlackBerry device user input and navigation
  • Touch screen
  • Trackball or trackpad
    • Trackball sensitivity
    • Trackball movement
  • Trackwheel
  • Keyboard
  • Interaction methods on BlackBerry devices
• Navigation events
  • Respond to navigation events
  • Determine the type of input method
  • Touch screen interaction models
  • Responding to touch screen events
    • Respond to system events while the user touches the screen
    • Respond to a user sliding a finger up quickly on the screen
    • Respond to a user sliding a finger down quickly on the screen
    • Respond to a user sliding a finger to the left quickly on the screen
    • Respond to a user sliding a finger to the right quickly on the screen
    • Respond to a user clicking the screen
    • Respond to a user touching the screen twice quickly
    • Respond to a user touching and dragging an item on the screen
    • Respond to a user touching the screen lightly
    • Respond to a scroll action
    • Respond to a user touching the screen in two locations at the same time
  • Pinch gestures
    • Enable pinch gestures
  • Swipe gestures with trackpads
    • Enable swipe gestures that users make on the trackpad
  • Event injection
• Accelerometer
  • Types of accelerometer data
  • Retrieving accelerometer data
  • Retrieve accelerometer data at specific intervals
  • Query the accelerometer when the application is in the foreground
  • Query the accelerometer when the application is in the background
  • Store accelerometer readings in a buffer
  • Retrieve accelerometer readings from a buffer
  • Get the time a reading was taken from the accelerometer
• Magnetometer
  • Magnetometer data
  • Magnetometer coordinate systems
  • Check if BlackBerry device has a magnetometer
  • Listen for magnetometer data
  • Poll for magnetometer data
  • Configure and retrieve magnetometer sampling frequency
  • Code samples
    • Code sample: Creating and registering a magnetometer listener
    • Code sample: Retrieving information from magnetometer data
    • Code sample: Polling for magnetometer data
• Tutorial: Creating a custom button
  • Create the class files and image files
  • Set up the custom button class
  • Lay out the button
  • Paint the button
  • Handle user input
  • Create the application class
  • Create the screen class
• Related resources
• Glossary
• Provide feedback
• Document revision history
• Legal notice