MenuItemType

Since: BlackBerry 10.2.0

#include <bb/system/MenuItemType>

To link against this class, add the following line to your .pro file: LIBS += -lbbsystem

Specifies the different types of menu items.

MenuItems can be grouped into two general categories: "channels" and "shortcuts". "Channel" menu items represent plain invocation targets and are intended to be listed with other "channel" menu items.

"Shortcut" menu items represent invocation targets that include information to be used by the target as a suggestion for pre-populating data. The suggestions are based on frecency (frequent/recent) scores based on the user's device usage. By detecting that a MenuItem is a "shortcut", the application can display the MenuItem in a more prominent position in the target selection menu, since the MenuItem represents a task that the user commonly performs and is likely to want to perform again. "Shortcut" menu items also include presentation information that set them apart from other menu items.

For example, if the device user frequently shares images to a specific contact using email, the "Share" MenuItem may contain both a "channel" MenuItem to represent the general share-by-email invocation (without a pre-selected contact), and a "shortcut" MenuItem to represent the share-by-email to the specific contact. The "shortcut" MenuItem will have a the contact's display name as the label, and the contact's avatar as the icon. The "shortcut" MenuItem can be displayed prominently, and when selected will invoke the email composer which will pre-populate the "To:" field with the contact's email address, instead of requiring the user to enter the email address.


Overview

Public Types Index

Public Types

Type

Specifies the different types of menu items.

Since:

BlackBerry 10.2.0

Unspecified = 0

No type specified.

Channel = 1

Specifies that the MenuItem represents an invocation that does not include any shortcut information.

Since:

BlackBerry 10.2.0

ContactShortcut = 2

Specifies that the MenuItem represents an invocation including a suggested contact-related identifier.

Since:

BlackBerry 10.2.0

AccountShortcut = 3

Specifies that the MenuItem represents an invocation including a suggested account-related identifier.

Since:

BlackBerry 10.2.0

EventShortcut = 4

Specifies that the MenuItem represents an invocation related to a calendar event.

Since:

BlackBerry 10.2.0

Last modified: 2014-09-29



Got questions about leaving a comment? Get answers from our Disqus FAQ.

comments powered by Disqus