Profile box (bbmsp_user_profile_box.h)
Functions to access the items in the user's profile box for your app.
This file declares functions and structures that you can use to manage the items in the profile box for your app. The user profile box is an area for your app that appears in the current user's BlackBerry Messenger profile. Each box contains a list of items, each composed of text and an optional icon. A profile box can contain a maximum of 3 items. As new items are added, older items are removed automatically.
This box can be viewed by the current user and their contacts. It can be modified by the current user and the app that owns it. The current user can remove items only.
The user can control whether an app's profile box appears in their profile by using the global settings application. The application is only allowed to make changes if the user enables this option. This can be checked using bbmsp_can_show_profile_box() .
The user can invoke the app from its profile box in their BBM profile or a contact's BBM profile. The app will be brought to the foreground and launched if it's not already running. Contacts who do not have the app installed will be brought to the app's page in App World if that app version is being served on App World.