InvokeTarget

Since: BlackBerry 10.0.0

#include <bb/system/InvokeTarget>

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

The InvokeTarget class represents a remote application, card, or service that can be invoked.


Overview

Public Types Index

enum Type

Unspecified = 0x0, Application = 0x1, Card = 0x2, Service = 0x8, Self = 0x10, Headless = 0x40

Public Functions Index

InvokeTarget ()
InvokeTarget (const InvokeTarget &other)
~InvokeTarget ()
QUrlicon () const
QStringlabel () const
QStringname () const
InvokeTarget &operator= (const InvokeTarget &other)
bb::system::SecurityPerimeter::Typeperimeter () const
Typetype () const

Public Types

Type

The kinds of processes that can be targets.

Since:

BlackBerry 10.0.0

Unspecified = 0x0

No target is specified.

Application = 0x1

The target is an application accessible from the home screen.

Since:

BlackBerry 10.0.0

Card = 0x2

The target is an application that runs using the full screen of the device, on top of any windows of the invoking parent application.

When an application is invoked as a card, it is considered to be part of the invoking application rather than a separately-running application. As such, an application running as a card does not appear in the list of running applications on the home screen.

Since:

BlackBerry 10.0.0

Service = 0x8

The target is a background process in the operating system.

Since:

BlackBerry 10.0.0

Self = 0x10

Include a target even if the target is the same as the client.

This value is valid only for specifying target types for invocation target queries. An InvokeTarget will not have type InvokeTarget::Self.

Since:

BlackBerry 10.0.0

Headless = 0x40

The target is a headless application.

Since:

BlackBerry 10.3.0

Public Functions

InvokeTarget ()

Creates a new InvokeTarget object.

Since:

BlackBerry 10.0.0

InvokeTarget (

Creates a copy of an existing InvokeTarget object.

Parameters
other

The source InvokeTarget object to copy.

Since:

BlackBerry 10.0.0

~InvokeTarget ()

Destructor.

Since:

BlackBerry 10.0.0

QUrl icon ()

Returns a path to a localized icon file that represents the target.

Return:

A path to a localized icon file that represents the target.

Since:

BlackBerry 10.0.0

QString label ()

Returns the localized name of the target.

Return:

The localized name of the target.

Since:

BlackBerry 10.0.0

QString name ()

Returns the identity of the target as stated in its BAR manifest.

Use value with InvokeRequest::setTarget().

Return:

The identity of the target.

Since:

BlackBerry 10.0.0

InvokeTarget & operator= (

Copies the data of an existing InvokeTarget object to this object.

Parameters
other

The source InvokeTarget object to copy.

Return:

The InvokeTarget instance.

Since:

BlackBerry 10.0.0

bb::system::SecurityPerimeter::Type perimeter ()

Returns the security perimeter of the target.

Return:

The target's security perimeter. See bb::system::SecurityPerimeter for the list of perimeters.

Since:

BlackBerry 10.0.0

Type type ()

Returns whether the target is an application, or a card.

Return:

The kind of process represented by the target. See InvokeTarget::Type for the list of invocation target types.

Since:

BlackBerry 10.0.0

Last modified: 2014-09-29



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

comments powered by Disqus