BlackBerry Theme BuilderFeatures Supported in BlackBerry Device SoftwareVersion: 6.0

Reference Guide

Published: 2011-05-13SWD-1490456-0513075850-001

Contents1 BlackBerry Theme Builder feature support...................................................................................................... 2

2 Devices that each version of the BlackBerry Device Software supports.......................................................... 8

3 Maximum size of theme files............................................................................................................................ 10

4 Glossary............................................................................................................................................................ 11

5 Provide feedback.............................................................................................................................................. 12

6 Legal notice....................................................................................................................................................... 13

BlackBerry Theme Builder feature support 1When you use the BlackBerry® Theme Builder to create themes, you might encounter version compatibility issues when you export your theme to a BlackBerry device. The BlackBerry device might be running a version of the BlackBerry® Device Software that does not support the features that are available in the version of the BlackBerry Theme Builder that you use to create the theme.

You can use the following table to help verify the features that different versions of the BlackBerry Theme Builder and BlackBerry Device Software support.

BlackBerry Theme Builder was previously known as Plazmic® Theme Builder.

Feature Introduced in BlackBerry Theme Builder version

4.5 4.6 4.7 5.0 6

Fontsinternational characters 4.2 ✓ ✓ ✓ ✓ ✓TrueType fonts 4.2 ✓ ✓ ✓ ✓ ✓stroke customization 4.2.2 ✓ ✓ ✓ ✓ ✓opacity customization 4.5 ✓ ✓ ✓ ✓ ✓

Preferencesvendor, copyright, version, and description in theme files

4.5 ✓ ✓ ✓ ✓ ✓

multiple inboxes to separate MMS messages and SMS text messages

4.5 ✓ ✓ ✓ ✓

Bannerssignal meter customization 4.2 ✓ ✓ ✓ ✓ ✓layout customization 4.2 ✓ ✓ ✓ ✓ ✓text customization 4.2 ✓ ✓ ✓ ✓ ✓banner height customization (Home screen) 4.2.2 ✓ ✓ ✓ ✓ ✓banner height customization (Application List screen)

4.2.2 ✓ ✓ ✓ ✓

Network signal indicator customization 4.2 ✓ ✓ ✓ ✓ ✓Wi-Fi® signal indicator customization 4.2.2 ✓ ✓ ✓ ✓ ✓Battery indicator customization 4.2 ✓ ✓ ✓ ✓ ✓banner item repositioning (Home screen) 4.2 ✓ ✓ ✓ ✓ ✓banner item repositioning (Application List screen)

4.2 ✓ ✓ ✓ ✓

Application screen banner customization 4.6 ✓ ✓ ✓ ✓

Reference Guide BlackBerry Theme Builder feature support

2

Feature Introduced in BlackBerry Theme Builder version

4.5 4.6 4.7 5.0 6

New Items indicator customization 4.2.2 ✓ ✓ ✓ ✓ ✓Wi-Fi icon customization (Wi-Fi enabled BlackBerry devices)

4.2.2 ✓ ✓ ✓ ✓ ✓

Focus underlay icon customization 4.2.2 ✓ ✓ ✓ ✓ ✓text alignment options 4.5 ✓ ✓ ✓ ✓ ✓ability to hide items on the banner (Home screen)

4.2.2 ✓ ✓ ✓ ✓

ability to hide items on the banner (Application List screen)

4.2.2 ✓ ✓ ✓

ability to have different background images for the banners on the Application screen and the Home screen

4.6 ✓ ✓ ✓ ✓

ability to set the banner to take up the full screen (Home screen banner in Custom theme layouts)

4.6 ✓ ✓ ✓ ✓

Profile icon resizing 4.7 ✓ ✓ ✓

Home screenUniversal search customization (background, Search icon, text, background, focus)

6.0 ✓

Overlay and Underlay icon customization (Home screens in Custom theme layouts)

5.0 ✓ ✓ ✓ ✓

Overlay and Underlay icon customization (Home screens in Custom 6 theme layouts)

6.0 ✓

Custom theme layout 4.5 ✓ ✓ ✓ ✓Custom 6 theme layout 6.0 ✓BlackBerry 6 theme layout 6.0 ✓number of subentries to display (Today, Custom, theme layouts)

4.6 ✓ ✓ ✓ ✓

number of subentries to display (Custom 6 theme layouts)

6.0 ✓

flash and glow animation for icons (Custom theme layouts)

4.5 ✓ ✓ ✓ ✓

flash and glow animation for icons (Custom 6 theme layouts)

6.0 ✓

Tab and Tab Focus images (Custom theme layouts)

4.6 ✓ ✓ ✓ ✓

Reference Guide BlackBerry Theme Builder feature support

3

Feature Introduced in BlackBerry Theme Builder version

4.5 4.6 4.7 5.0 6

Tab and Tab Focus images (Custom 6 theme layouts)

6.0 ✓

Home screen animation by using an SVG file 4.6 ✓ ✓ ✓ ✓Today Area customization (Custom theme layout)

4.6 ✓ ✓ ✓

Today Area customization (Custom 6 theme layout)

6.0 ✓

navigation order changes (Custom theme layouts)

4.6 ✓ ✓ ✓

navigation order changes (Custom 6 theme layouts)

6.0 ✓

Home screen customization in landscape mode (BlackBerry devices with a touch screen)

5.0 ✓ ✓ ✓

Today support for BlackBerry® Messenger (Custom and Custom 6 theme layouts)

6.0 ✓

Today support for the Facebook® and Twitter® applications (Custom 6 theme layouts)

6.0 ✓

Today support for tasks, memos (Custom and Custom 6 theme layouts)

✓

Event based wallpaper (BlackBerry 6 theme layouts)

6.0 ✓

Slideshow wallpaper 6.0 ✓

Today Home Screen (BlackBerry 6 theme layout)Title text customization 6.0 ✓Subentry text customization 6.0 ✓Background customization 6.0 ✓Caret customization 6.0 ✓

Application listAlarm icon customization 4.2 ✓Application order customization 4.2 ✓ ✓ ✓ ✓Overlay customization for an icon that is in focus 4.2 ✓ ✓ ✓ ✓ ✓Default Folder customization 4.2.2 ✓ ✓ ✓ ✓ ✓Manage Connections customization (Bluetooth® On, Bluetooth Off, Radio On, and Radio Off)

4.2.2 ✓ ✓ ✓ ✓ ✓

Reference Guide BlackBerry Theme Builder feature support

4

Feature Introduced in BlackBerry Theme Builder version

4.5 4.6 4.7 5.0 6

adding third-party applications (Zen and Today themes)

5.0 ✓ ✓ ✓ ✓ ✓

web links 4.5 ✓ ✓ ✓ ✓ ✓Clock icon customization 4.6 ✓ ✓ ✓ ✓Move icon customization 4.7 ✓ ✓ ✓ ✓Word Mole® icon customization 4.6 ✓ ✓ ✓ ✓Profiles Medium icon customization 4.7 ✓ ✓ ✓Application Center icon customization 4.7 ✓ ✓Ringtones icon customization 5.0 ✓ ✓Downloads folder icon customization 5.0 ✓Games folder icon customization 5.0 ✓ ✓Instant Messaging folder icon customization 5.0 ✓ ✓Pictures icon customization 5.0 ✓ ✓Setup folder icon customization 5.0 ✓Videos icon customization 5.0 ✓ ✓Applications folder icon customization 5.0 ✓ ✓Files icon customization 5.0 ✓ ✓Music icon customization 5.0 ✓ ✓Text messages icon customization 6.0 ✓Podcasts icon customization 6.0 ✓Visual voice mail icon customization 6.0 ✓Setup icon customization 6.0 ✓Social Feeds icon customization 6.0 ✓Calendar icon (dynamic) 6.0 ✓Tray customization (text, background, highlight) 6.0 ✓

Controlsbackground customization for lists 4.2 ✓ ✓ ✓ ✓ ✓text customization for lists 4.2 ✓ ✓ ✓ ✓ ✓cursor customization for lists 4.2 ✓ ✓ ✓ ✓ ✓Alarm icon customization (in dialog boxes) 4.5 ✓ ✓ ✓ ✓ ✓Memory Cleaner icon customization (in dialog boxes)

4.5 ✓ ✓ ✓ ✓ ✓

color customization of alternating lines (stripes) for lists

4.6 ✓ ✓ ✓ ✓ ✓

search field customization 5.0 ✓ ✓ ✓

Reference Guide BlackBerry Theme Builder feature support

5

Feature Introduced in BlackBerry Theme Builder version

4.5 4.6 4.7 5.0 6

gradient color for cursors (for menus, title bars, lists)

5.0 ✓ ✓ ✓

Disabled button customization 5.0 ✓ ✓ ✓Disabled Highlight button customization 5.0 ✓ ✓ ✓Active button customization 5.0 ✓ ✓ ✓Normal Arrow button customization 5.0 ✓ ✓ ✓Highlight Arrow button customization 5.0 ✓ ✓ ✓Group box customization (title text, body text, text highlight, title background, title background highlight, body background)

6.0 ✓

Pop-up menu customization (text, background, tab focus)

6.0 ✓

Message list background customization 4.2 ✓ ✓ ✓ ✓ ✓message list icons customization 4.5 ✓ ✓ ✓ ✓ ✓

Phone screentext color customization for My Number 4.2 ✓ ✓ ✓ ✓ ✓Incoming Call screen customization 4.2 ✓ ✓ ✓ ✓ ✓Phone icons customization (Phone Hotlist, Incoming Call, and Active Call screens)

4.6 ✓ ✓ ✓ ✓ ✓

background customization (Active Call screen) 4.6 ✓ ✓ ✓ ✓Ringtone customization for incoming calls 5.0 ✓ ✓Icon customization for Active Call screen (Speaker, Bluetooth, Hold, Resume, Mute, Unmute, Join, Add Participant, Head Set, Hand Set)

6.0 ✓

Lock screenBackground customization 4.2 ✓ ✓ ✓ ✓ ✓Lock icon customization 4.5 ✓ ✓ ✓ ✓ ✓Lock screen animation by using an SVG file 4.6 ✓ ✓ ✓ ✓ ✓

Shortcut barLeft icon and Right icon customization (status bar on the BlackBerry® Storm™ 9500 smartphone)

5.0 ✓ ✓

External screen

Reference Guide BlackBerry Theme Builder feature support

6

Feature Introduced in BlackBerry Theme Builder version

4.5 4.6 4.7 5.0 6

external screen customization (BlackBerry® Pearl™ 8220 smartphone)

4.6 ✓ ✓ ✓ ✓

Global itemscolor customization for the progress bar 4.2 ✓ ✓ ✓ ✓ ✓Key modifiers (ALT, SHIFT) 4.7 ✓ ✓ ✓ ✓ ✓Hourglass icon customization 4.2 ✓ ✓ ✓ ✓ ✓scroll arrows customization 4.2 ✓ ✓ ✓ ✓ ✓reception indicator and transmission indicator customization

4.2 ✓ ✓ ✓ ✓ ✓

text color customization for all applications 4.6 ✓ ✓ ✓ ✓ ✓screen transitions 5.0 ✓ ✓ ✓

Reference Guide BlackBerry Theme Builder feature support

7

Devices that each version of the BlackBerry Device Software supports

2

Each BlackBerry® device runs on a specific version of the BlackBerry® Device Software. When you export a theme, you can use this table as a reference to determine the device and BlackBerry Device Software combination that you want to make the theme available for.

BlackBerry device BlackBerry Device Software

BlackBerry® Bold™ 9780 BlackBerry® 6BlackBerry® Bold™ 9700 BlackBerry 6

BlackBerry Device Software 5.0BlackBerry® Bold™ 9650 BlackBerry 6

BlackBerry Device Software 5.0BlackBerry® Bold™ 9000 BlackBerry Device Software 5.0

BlackBerry Device Software 4.6BlackBerry® Curve™ 9330 BlackBerry 6

BlackBerry Device Software 5.0BlackBerry® Curve™ 9300 BlackBerry 6

BlackBerry Device Software 5.0BlackBerry® Curve™ 8910 BlackBerry Device Software 5.0BlackBerry® Curve™ 8900 BlackBerry Device Software 5.0

BlackBerry Device Software 4.6.1BlackBerry® Curve™ 8530 BlackBerry Device Software 5.0BlackBerry® Curve™ 8520 BlackBerry Device Software 5.0

BlackBerry Device Software 4.6.1BlackBerry® Curve™ 8300 Series BlackBerry Device Software 4.5BlackBerry® Curve™ 8350i BlackBerry Device Software 5.0

BlackBerry Device Software 4.6.1BlackBerry® Curve™ 8330 BlackBerry Device Software 5.0

BlackBerry Device Software 4.5BlackBerry® Pearl™ 9105 BlackBerry 6

BlackBerry Device Software 5.0BlackBerry® Pearl™ 9100 BlackBerry 6

BlackBerry Device Software 5.0BlackBerry® Pearl™ 8230 BlackBerry Device Software 4.6.1

Reference Guide Devices that each version of the BlackBerry Device Software supports

8

BlackBerry device BlackBerry Device Software

BlackBerry® Pearl™ 8220 BlackBerry Device Software 4.6BlackBerry® Pearl™ 8100 BlackBerry Device Software 4.5BlackBerry® Style™ 9670 BlackBerry 6BlackBerry® Storm2™ 9550 BlackBerry Device Software 5.0BlackBerry® Storm™ 9530 BlackBerry Device Software 5.0

BlackBerry Device Software 4.7BlackBerry® Storm2™ 9520 BlackBerry Device Software 5.0BlackBerry® Storm™ 9500 BlackBerry Device Software 5.0

BlackBerry Device Software 4.7BlackBerry® Torch™ 9800 BlackBerry 6BlackBerry® Tour™ 9630 BlackBerry Device Software 5.0

BlackBerry Device Software 4.7.1BlackBerry® 8800 Series BlackBerry Device Software 4.5BlackBerry® 8700 Series BlackBerry Device Software 4.5

Reference Guide Devices that each version of the BlackBerry Device Software supports

9

Maximum size of theme files 3The maximum size of a theme file that you can export to a BlackBerry® device depends on the version of the BlackBerry® Device Software that is running on the BlackBerry device.

BlackBerry Device Software version Maximum size of a theme file

4.5 1.5 MB4.6 to 4.6.1 2.5 MB4.7 to 4.7.1 3.5 MB5.0 to 6.0 5.0 MB

Reference Guide Maximum size of theme files

10

Glossary 4MMS

Multimedia Messaging Service

SMSShort Message Service

SVGScalable Vector Graphics

Reference Guide Glossary

11

Provide feedback 5To provide feedback on this content, visit www.blackberry.com/docsfeedback.

Reference Guide Provide feedback

12

Legal notice 6©2011 Research In Motion Limited. All rights reserved. BlackBerry®, RIM®, Research In Motion®, and related trademarks, names, and logos are the property of Research In Motion Limited and are registered and/or used in the U.S. and countries around the world.

Bluetooth is a trademark of Bluetooth SIG. Facebook is a trademark of Facebook, Inc. Plazmic is a trademark of Plazmic Inc. TrueType is a trademark of Apple Inc. Twitter is a trademark of Twitter, Inc. Wi-Fi is a trademark of the Wi-Fi Alliance. All other trademarks are the property of their respective owners.

This documentation including all documentation incorporated by reference herein such as documentation provided or made available at www.blackberry.com/go/docs is provided or made accessible "AS IS" and "AS AVAILABLE" and without condition, endorsement, guarantee, representation, or warranty of any kind by Research In Motion Limited and its affiliated companies ("RIM") and RIM assumes no responsibility for any typographical, technical, or other inaccuracies, errors, or omissions in this documentation. In order to protect RIM proprietary and confidential information and/or trade secrets, this documentation may describe some aspects of RIM technology in generalized terms. RIM reserves the right to periodically change information that is contained in this documentation; however, RIM makes no commitment to provide any such changes, updates, enhancements, or other additions to this documentation to you in a timely manner or at all.

This documentation might contain references to third-party sources of information, hardware or software, products or services including components and content such as content protected by copyright and/or third-party web sites (collectively the "Third Party Products and Services"). RIM does not control, and is not responsible for, any Third Party Products and Services including, without limitation the content, accuracy, copyright compliance, compatibility, performance, trustworthiness, legality, decency, links, or any other aspect of Third Party Products and Services. The inclusion of a reference to Third Party Products and Services in this documentation does not imply endorsement by RIM of the Third Party Products and Services or the third party in any way.

EXCEPT TO THE EXTENT SPECIFICALLY PROHIBITED BY APPLICABLE LAW IN YOUR JURISDICTION, ALL CONDITIONS, ENDORSEMENTS, GUARANTEES, REPRESENTATIONS, OR WARRANTIES OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION, ANY CONDITIONS, ENDORSEMENTS, GUARANTEES, REPRESENTATIONS OR WARRANTIES OF DURABILITY, FITNESS FOR A PARTICULAR PURPOSE OR USE, MERCHANTABILITY, MERCHANTABLE QUALITY, NON-INFRINGEMENT, SATISFACTORY QUALITY, OR TITLE, OR ARISING FROM A STATUTE OR CUSTOM OR A COURSE OF DEALING OR USAGE OF TRADE, OR RELATED TO THE DOCUMENTATION OR ITS USE, OR PERFORMANCE OR NON-PERFORMANCE OF ANY SOFTWARE, HARDWARE, SERVICE, OR ANY THIRD PARTY PRODUCTS AND SERVICES REFERENCED HEREIN, ARE HEREBY EXCLUDED. YOU MAY ALSO HAVE OTHER RIGHTS THAT VARY BY STATE OR PROVINCE. SOME JURISDICTIONS MAY NOT ALLOW THE EXCLUSION OR LIMITATION OF IMPLIED WARRANTIES AND CONDITIONS. TO THE EXTENT PERMITTED BY LAW, ANY IMPLIED WARRANTIES OR CONDITIONS RELATING TO THE DOCUMENTATION TO THE EXTENT THEY CANNOT BE EXCLUDED AS SET OUT ABOVE, BUT CAN BE LIMITED, ARE HEREBY LIMITED TO NINETY (90) DAYS FROM THE DATE YOU FIRST ACQUIRED THE DOCUMENTATION OR THE ITEM THAT IS THE SUBJECT OF THE CLAIM.

TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW IN YOUR JURISDICTION, IN NO EVENT SHALL RIM BE LIABLE FOR ANY TYPE OF DAMAGES RELATED TO THIS DOCUMENTATION OR ITS USE, OR PERFORMANCE OR NON-PERFORMANCE OF ANY SOFTWARE, HARDWARE, SERVICE, OR ANY THIRD PARTY PRODUCTS AND SERVICES REFERENCED HEREIN INCLUDING WITHOUT LIMITATION ANY OF THE FOLLOWING DAMAGES: DIRECT,

Reference Guide Legal notice

13

CONSEQUENTIAL, EXEMPLARY, INCIDENTAL, INDIRECT, SPECIAL, PUNITIVE, OR AGGRAVATED DAMAGES, DAMAGES FOR LOSS OF PROFITS OR REVENUES, FAILURE TO REALIZE ANY EXPECTED SAVINGS, BUSINESS INTERRUPTION, LOSS OF BUSINESS INFORMATION, LOSS OF BUSINESS OPPORTUNITY, OR CORRUPTION OR LOSS OF DATA, FAILURES TO TRANSMIT OR RECEIVE ANY DATA, PROBLEMS ASSOCIATED WITH ANY APPLICATIONS USED IN CONJUNCTION WITH RIM PRODUCTS OR SERVICES, DOWNTIME COSTS, LOSS OF THE USE OF RIM PRODUCTS OR SERVICES OR ANY PORTION THEREOF OR OF ANY AIRTIME SERVICES, COST OF SUBSTITUTE GOODS, COSTS OF COVER, FACILITIES OR SERVICES, COST OF CAPITAL, OR OTHER SIMILAR PECUNIARY LOSSES, WHETHER OR NOT SUCH DAMAGES WERE FORESEEN OR UNFORESEEN, AND EVEN IF RIM HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW IN YOUR JURISDICTION, RIM SHALL HAVE NO OTHER OBLIGATION, DUTY, OR LIABILITY WHATSOEVER IN CONTRACT, TORT, OR OTHERWISE TO YOU INCLUDING ANY LIABILITY FOR NEGLIGENCE OR STRICT LIABILITY.

THE LIMITATIONS, EXCLUSIONS, AND DISCLAIMERS HEREIN SHALL APPLY: (A) IRRESPECTIVE OF THE NATURE OF THE CAUSE OF ACTION, DEMAND, OR ACTION BY YOU INCLUDING BUT NOT LIMITED TO BREACH OF CONTRACT, NEGLIGENCE, TORT, STRICT LIABILITY OR ANY OTHER LEGAL THEORY AND SHALL SURVIVE A FUNDAMENTAL BREACH OR BREACHES OR THE FAILURE OF THE ESSENTIAL PURPOSE OF THIS AGREEMENT OR OF ANY REMEDY CONTAINED HEREIN; AND (B) TO RIM AND ITS AFFILIATED COMPANIES, THEIR SUCCESSORS, ASSIGNS, AGENTS, SUPPLIERS (INCLUDING AIRTIME SERVICE PROVIDERS), AUTHORIZED RIM DISTRIBUTORS (ALSO INCLUDING AIRTIME SERVICE PROVIDERS) AND THEIR RESPECTIVE DIRECTORS, EMPLOYEES, AND INDEPENDENT CONTRACTORS.

IN ADDITION TO THE LIMITATIONS AND EXCLUSIONS SET OUT ABOVE, IN NO EVENT SHALL ANY DIRECTOR, EMPLOYEE, AGENT, DISTRIBUTOR, SUPPLIER, INDEPENDENT CONTRACTOR OF RIM OR ANY AFFILIATES OF RIM HAVE ANY LIABILITY ARISING FROM OR RELATED TO THE DOCUMENTATION.

Prior to subscribing for, installing, or using any Third Party Products and Services, it is your responsibility to ensure that your airtime service provider has agreed to support all of their features. Some airtime service providers might not offer Internet browsing functionality with a subscription to the BlackBerry® Internet Service. Check with your service provider for availability, roaming arrangements, service plans and features. Installation or use of Third Party Products and Services with RIM's products and services may require one or more patent, trademark, copyright, or other licenses in order to avoid infringement or violation of third party rights. You are solely responsible for determining whether to use Third Party Products and Services and if any third party licenses are required to do so. If required you are responsible for acquiring them. You should not install or use Third Party Products and Services until all necessary licenses have been acquired. Any Third Party Products and Services that are provided with RIM's products and services are provided as a convenience to you and are provided "AS IS" with no express or implied conditions, endorsements, guarantees, representations, or warranties of any kind by RIM and RIM assumes no liability whatsoever, in relation thereto. Your use of Third Party Products and Services shall be governed by and subject to you agreeing to the terms of separate licenses and other agreements applicable thereto with third parties, except to the extent expressly covered by a license or other agreement with RIM.

Certain features outlined in this documentation require a minimum version of BlackBerry® Enterprise Server, BlackBerry® Desktop Software, and/or BlackBerry® Device Software.

Reference Guide Legal notice

14

The terms of use of any RIM product or service are set out in a separate license or other agreement with RIM applicable thereto. NOTHING IN THIS DOCUMENTATION IS INTENDED TO SUPERSEDE ANY EXPRESS WRITTEN AGREEMENTS OR WARRANTIES PROVIDED BY RIM FOR PORTIONS OF ANY RIM PRODUCT OR SERVICE OTHER THAN THIS DOCUMENTATION.

Research In Motion Limited295 Phillip StreetWaterloo, ON N2L 3W8Canada

Research In Motion UK Limited Centrum House 36 Station Road Egham, Surrey TW20 9LF United Kingdom

Published in Canada

Reference Guide Legal notice

15