EZ_DestroyWidget(3)

NAME
EZ_DestroyWidget - destroy a widget and its descendants

SYNOPSIS
#include <EZ.h>

void EZ_DestroyWidget( EZ_Widget *widget)

ARGUMENTS
widget Specifies an EZ widget.

DESCRIPTION

EZ_DestroyWidget destroies a widget and all its descendants. It invokes the destroy callbacks registered to widget and releases all resources allocated for widget. A destroied widget should never be referenced again.

The actual destruction is completed in two steps. In the first step, it recursively descends the widget tree, remove the widget and its children from the widget hash table, inserts them into the destroyed widget list and mark the widget and its children destroyed. In the second step, it invokes the destroy callbacks in post-order (invoke children's destroy callbacks first) and then dereference the allocated resources.

SEE ALSO
EZ_CreateWidget(3)