Warning: main(/www/www/htdocs/style/globals.php) [function.main]: failed to open stream: No such file or directory in /www/www/docs/6.4.1/photon/lib_ref/ap/apwidget.html on line 1

Warning: main() [function.include]: Failed opening '/www/www/htdocs/style/globals.php' for inclusion (include_path='.:/www/www/common:/www/www/php/lib/php') in /www/www/docs/6.4.1/photon/lib_ref/ap/apwidget.html on line 1

Warning: main(/www/www/htdocs/style/header.php) [function.main]: failed to open stream: No such file or directory in /www/www/docs/6.4.1/photon/lib_ref/ap/apwidget.html on line 8

Warning: main() [function.include]: Failed opening '/www/www/htdocs/style/header.php' for inclusion (include_path='.:/www/www/common:/www/www/php/lib/php') in /www/www/docs/6.4.1/photon/lib_ref/ap/apwidget.html on line 8

ApWidget()

Determine the widget that initiated a link callback

Synopsis:

#include <Ap.h>

PtWidget_t *ApWidget( PtCallbackInfo_t *cbinfo );

Arguments:

cbinfo
A pointer to the PtCallbackInfo_t structure (see the Photon Widget Reference) that was passed to the callback.

Library:

Ap

Description:

ApWidget() is used within module setup functions to determine the widget that initiated the link callback.

Returns:

A pointer to the initiating widget.

Examples:

mysetup_function( ..., PtCallbackInfo_t cbinfo ) {
    if (ApName(ApWidget(cbinfo)) == ABN_widget1) {
        /* setup based on widget1 */
    } else {
        if (ApName(ApWidget(cbinfo)) == ABN_widget2) {
            /* setup based on widget2 */
        } else {
            /* common setup */
        }
    }
    return( Pt_CONTINUE );
}

Classification:

Photon

Safety:
Interrupt handler No
Signal handler No
Thread No

See also:

For another method of determining the widget that initiated a link callback, see the ApInfo_t structure.

PtCallbackInfo_t in the Photon Widget Reference

Module setup functions in the Working With Code chapter of the Photon Programmer's Guide


Warning: main(/www/www/htdocs/style/footer.php) [function.main]: failed to open stream: No such file or directory in /www/www/docs/6.4.1/photon/lib_ref/ap/apwidget.html on line 131

Warning: main() [function.include]: Failed opening '/www/www/htdocs/style/footer.php' for inclusion (include_path='.:/www/www/common:/www/www/php/lib/php') in /www/www/docs/6.4.1/photon/lib_ref/ap/apwidget.html on line 131