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

PtAddCallbacks()

Add several callback entries to a callback list

Synopsis:

void PtAddCallbacks(
        PtWidget_t *widget,
        unsigned long callback_type,
        PtCallback_t const *callback_defs,
        unsigned int num_callbacks );

Library:

ph

Description:

This function adds the number of callbacks specified by num_callbacks to the callback list specified by callback_type (e.g. Pt_CB_ACTIVATE).

Some types of callback resources have special routines that you should use instead of this one: Pt_CB_FILTER PtAddFilterCallback() or PtAddFilterCallbacks() Pt_CB_HOTKEY PtAddHotkeyHandler() Pt_CB_RAW PtAddEventHandler() or PtAddEventHandlers()

The callback_defs argument contains the address of an array of PtCallback_t structures. See the Photon Widget Reference.

Examples:

PtWidget_t *widget
PtCallback_t callbacks[]={
    my_first_callback, NULL ,
    my_second_callback, "Number 2",
    my_last_callback, NULL
    };
...
PtAddCallbacks( widget, Pt_CB_ACTIVATE, callbacks, 3 );

Classification:

Photon

See also:

PtAddCallback(), PtAddEventHandler(), PtAddEventHandlers(), PtAddFilterCallback(), PtAddFilterCallbacks(), PtAddHotkeyHandler(), PtRemoveCallback(), PtRemoveCallbacks(),

PtCallback_t in the Photon Widget Reference

Managing Widgets in Application Code chapter of the Photon Programmer's Guide