Remove a widget from the widget family hierarchy
int PtDestroyWidget( PtWidget_t *widget );
ph
This function performs the following on the specified widget:
The widget's resources aren't freed until the return of PtEventHandler().
You might get callbacks from the widget after PtDestroyWidget() has
returned.
To determine if this is happening, check the widget's
Pt_DESTROYED flag.
For example:
if (PtWidgetFlags(widget) & Pt_DESTROYED) { return( Pt_CONTINUE ); } |
See PtContainerBox().
Photon
Safety: | |
---|---|
Interrupt handler | No |
Signal handler | No |
Thread | No |
PtEventHandler(), PtCreateWidget(), PtRealizeWidget(), PtUnrealizeWidget(), PtWidgetFlags()
Pt_ARG_FLAGS, Pt_CB_DESTROYED, Pt_CB_IS_DESTROYED resources of PtWidget in the Widget Reference
“Widget life cycle” in the Introduction to the Photon Programmer's Guide