Caution: This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

PtCallbackInfo_t

Specific callback information

Synopsis:

typedef struct Pt_callback_info {
    unsigned long  reason;
    unsigned long  reason_subtype;
    PhEvent_t      *event;
    void           *cbdata;
    } PtCallbackInfo_t;

Description:

The PtCallbackInfo_t structure is the third argument passed to all callback functions. You can use this structure to determine why callbacks occurred and to get the specific callback information.

The structure contains at least the following members:

reason
The reason why this callback was invoked. For example, if you cause the widget to invoke its Pt_CB_ACTIVATE callback, reason is Pt_CB_ACTIVATE.
reason_subtype
If there are different ways to invoke the callback, this member indicates which one.
event
A pointer to a PhEvent_t structure that describes the event that caused this callback to be invoked.
cbdata
A pointer to callback-specific data.

For more information about these fields, see the descriptions of callbacks for each widget.

Classification:

Photon

See also:

PtBalloonCallback_t, PtCallback_t, PtHotkeyCallback_t, PtRawCallback_t

PhEvent_t in the Photon Library Reference