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


Home
QNX Community Resources
QNX Documentation Library
ApModuleParent

ApModuleParent

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

ApModuleParent()

Specify the parent for a window or dialog module

Synopsis:

#include <Ap.h>

void ApModuleParent( ApEventLink_t *link_callback,
                     int parent,
                     PtWidget_t *widget );

Arguments:

link_callback
The ABM_ link callback for the module whose parent you want to specify.
parent
One of the following:
  • AB_PARENT -- the widget argument points to the module's new parent.
  • AB_NO_PARENT -- the module should have no parent. The widget argument is ignored.
widget
A pointer to the widget that you want to be the parent of the module.

Library:

Ap

Description:

ApModuleParent() lets you specify the parent module for a window or dialog module.

Examples:

Change my_window to have no parent at all:

ApModuleParent( ABM_my_window, AB_NO_PARENT, NULL );
ApCreateModule( ABM_my_window, NULL, NULL );

Change new_window to have the base window as its parent:

ApModuleParent( ABM_new_window, AB_PARENT, ABW_base );
ApCreateModule( ABM_new_window, NULL, NULL );

Classification:

Photon

Safety:
Interrupt handler No
Signal handler No
Thread No

See also:

Accessing PhAB Modules from Code chapter of the Photon Programmer's Guide