Middleware, development tools, realtime operating system
software and services for superior embedded design


Home
QNX Community Resources
QNX Documentation Library
PtAddCallbacks

PtAddCallbacks

QNX Software Systems
Developer Resources
Blogs
Board support packages
Foundry27 projects
Forums
Hardware support listing
Online video tutorials
Product documentation
Technical Articles

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).


Note: 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

Safety:
Interrupt handler No
Signal handler No
Thread No

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