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 the user caused the widget to invoke its Pt_CB_ACTIVATE callback, then reason would be Pt_CB_ACTIVATE.

reason_subtype

If there are different ways to invoke the callback, this member indicates which one.

event

Pointer to the event that caused this callback to be invoked.

cbdata

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