Welcome to the official BlackBerry Support Community Forums.

This is your resource to discuss support topics with your peers, and learn from each other.

inside custom component

Java Development

Create an icon for an application

by Retired on ‎02-16-2010 09:07 AM - edited on ‎07-17-2012 09:30 AM by BlackBerry Development Advisor (18,460 Views)



This article applies to the following:

  • BlackBerry® Java® Development Environment (BlackBerry JDE)
  • BlackBerry® smartphones



For newer BlackBerry smartphones where themes apply, the resolution is dependent on the default theme. The icons can be in either GIF or PNG format. Refer to the Dimensions for application icons on BlackBerry devices document for a list of icon resolutions.


The image can be in color or monochrome, depending on the BlackBerry smartphone model. A monochrome BlackBerry smartphone can display a color icon; however, a detailed icon may appear distorted. Transparent areas of the image are supported and are used when the icon is selected on the BlackBerry smartphone.


When creating an icon that will be used on multiple BlackBerry smartphone models with different icon resolutions, it is important to understand how this icon will be displayed to make sure that it displays properly for all BlackBerry smartphone users.


On BlackBerry smartphones running BlackBerry Device Software prior to BlackBerry Device Software 4.2, icon images that are larger than the maximum icon resolution are cropped.


f you use an icon with a resolution higher than the resolution displayed on a BlackBerry smartphone, the icon will be scaled down to the BlackBerry smartphone’s maximum size on a BlackBerry smartphone running BlackBerry Device Software 4.2 through 4.5. If this scaling occurs on an image that is not square (that is, the width and height do not match) to a resolution that is square, or vice versa, the contents of your image may appear distorted. This may affect the appearance of the icon, depending on the icon image. For example, a circle may become an oval, which would be noticeable, but a textured pattern may not yield any visible difference.


If you use an icon of the smallest resolution on BlackBerry smartphones with BlackBerry Device Software 4.5 or earlier, it will not be scaled up on the BlackBerry smartphone with a higher resolution. The actual image size will be the same and the remainder of the icon area will be transparent, so the icon will appear smaller than the standard icons.


On BlackBerry smartphones with BlackBerry Device Software 4.6, icons are scaled in the application grid menu to match the icons of the current theme. If the third party icon is larger than the current theme icon, the icon is scaled down to match. If the third party icon is marginally smaller, it will be left un-scaled. If the third party icon is 25% (or more) smaller, it will be scaled up to match the current theme icon.


To register an application icon, complete the following steps:

  • Once the icon is created, add the image file to your project.
  • In the workspace view, right-click the file name, then select Properties. If the file can be used as an icon, the Use as Application Icon check box is displayed.
  • Select the Use as Application Icon check box to register this image as the application icon.

Note: You must compile your project again before this change will take effect.

by Developer
on ‎10-13-2010 01:12 AM

Link to BlackBerry UI Guidelines broken (redirect loop to 404 page).

by BlackBerry Development Advisor
on ‎10-13-2010 02:34 PM

Thanks for the heads up.  This will be fixed soon.

by Developer
on ‎10-10-2011 09:40 AM

First link is broken

by BlackBerry Development Advisor
on ‎10-11-2011 12:34 PM

Thanks, I'll update that right away.

Users Online
Currently online: 7 members 703 guests
Please welcome our newest community members: