Help Center
Local Navigation
- Creating user interfaces
- Screens
- UI components
- Add a UI component to a screen
- Create a dialog box
- Creat a bitmap
- Create a button
- Create a list
- Create an alphanumeric drop-down list
- Create a text list that can be filtered
- Create a check box
- Create a radio button
- Create a date field
- Create 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 password field
- Create a text field for AutoText
- Create a progress bar field
- Create a text label
- Create a list from which users can select multiple items
- Create a field to display a parent and child relationship between items
- Add a UI component to a screen
- Create a custom field
- Create a menu item
- Adding menu items to a BlackBerry device application
- Register a menu item
- Arrange UI components
- UI events
- Spell check
- Accessibility
- Notifying an assistive technology application when the UI changes
- UI changes that trigger a notification to an assistive technology application
- UI component states and properties
- Provide an assistive technology application with information about a UI change
- Provide an assistive technology application with information about text changes
- Provide an assistive technology application with access to information from a table
- Provide an assistive technology application with access to numeric values
- Allow an assistive technology application to receive notification of field changes
- Storing data
- Creating connections
- Network gateways
- Connections
- Wi-Fi connections
- Wireless access families
- Retrieve the wireless access families that a BlackBerry device supports
- Determine if a BlackBerry device supports multiple wireless access families
- Determine the wireless access family transceivers that are turned on
- Turn on the transceiver for a wireless access family
- Turn off the transceiver for a wireless access family
- Check if the Wi-Fi transceiver is turned on
- Check if the Wi-Fi transceiver is connected to a wireless access point
- Retrieve the status of the wireless access point or the active Wi-Fi profile
- Open a Wi-Fi socket connection
- Open a Wi-Fi HTTP connection
- Open a Wi-Fi HTTPS connection
- Managing applications
- Using custom messages and folders in the message list
- Creating a module for background processes
- Creating a module for the UI
- Create the module for background processes
- Start the module for background processes or the module for the UI
- Create an icon for a custom message
- Create a custom folder in the message list
- Send a notification when a custom folder changes
- Create an indicator for the number of messages in a custom folder
- Hide an indicator for a custom folder
- Remove an indicator for a custom folder
- Applications for push content
- Localizing BlackBerry device applications
- Controlling access to APIs and application data
- Check if a code signature is required
- Java APIs with controlled access
- Register to use controlled APIs
- Restrictions on code signatures
- Request a code signature
- Register a signature key using a proxy server
- Sign an application using a proxy server
- View the signature status for an application
- Using keys to protect APIs and data
- Protect APIs using code signing keys
- Protect runtime store data using code signing keys
- Protect persistent data using code signing keys
- Testing a BlackBerry device application
- Packaging and distributing a BlackBerry Java Application
- Preverify a BlackBerry device application
- Application distribution over the wireless network
- Wireless pull (user-initiated)
- Wireless push (server-initiated)
- Distributing BlackBerry Java Applications over the wireless network
- Distributing BlackBerry device applications with the BlackBerry Desktop Software
- Application distribution through a computer connection
- Distributing an application from a computer
- Create an application loader file
- Install a BlackBerry device application on a specific device
- Specifing supported versions of the BlackBerry Device Software
- Glossary
- Provide feedback
- Legal notice
BlackBerry Manuals & Help
>
Documentation for Developers
>
Java Development Guides and API Reference
>
Development Guide - BlackBerry Java Development Environment - 4.6.1
Create a custom folder in the message list
To be able to perform operations on custom messages, the BlackBerry® device application must register at least one custom folder.
- Import the following classes:
- Import the following interfaces:
- Create a class that implements the ApplicationMessage interface.
public class MLSampleMessage implements ApplicationMessage
- Obtain a reference to the ApplicationMessageFolderRegistry.
ApplicationMessageFolderRegistry reg = ApplicationMessageFolderRegistry.getInstance();
- Register an BlackBerrydevice application
folder for each collection of messages.
ReadableList inboxMessages = messages.getInboxMessages(); // collection with MLSampleMessage elements ReadableList deletedMessages = messages.getDeletedMessages(); // collection with MLSampleMessage elements ApplicationMessageFolder inboxFolder = reg.registerFolder( INBOX_FOLDER_ID, "Inbox", inboxMessages ); ApplicationMessageFolder deletedFolder = reg.registerFolder( DELETED_FOLDER_ID, "Deleted Messages", deletedMessages, false );
- Let an BlackBerrydevice application
be notified when specific folder events occur.
deletedFolder.addListener( this , ApplicationMessageFolderListener.MESSAGE_DELETED );
- Create a class that implements the ApplicationMessageFolderListener interface.
public class AppFolderListener implements ApplicationMessageFolderListener
- To let an BlackBerrydevice application
perform actions when a folder event occurs, implement the actionPerformed() method of the ApplicationMessageFolderListener interface.
public void actionPerformed( int action, ApplicationMessage[] messages, ApplicationMessageFolder folder ) { // check if action was performed on multiple messages if( messages.length == 1 ) { switch( action ) { case ApplicationMessageFolderListener.MESSAGE_DELETED: messageStore.deleteInboxMessage( message ); - Set the root folder for the folders of the BlackBerry device application. The name of the root folder appears in the View Folder dialog of the Message list application when a BlackBerry device application
registers more than one application message folder.
reg.setRootFolderName( "ML Sample" );
Parent topic: Using custom messages and folders in the message list