## 2.7 Displaying a Widget

Once a widget has been created and configured, it can be displayed by invoking `EZ_DisplayWidget`.

`void EZ_DisplayWidget(EZ_Widget *widget)`

The first time this function is called on a widget, it performs two tasks:

- Traverses the whole widget tree, computes the geometry of all widgets on the widget tree.

- Creates X windows for all widgets on the widget tree and maps them to the screen.

If it is called on a widget which has been previously displayed. The behavior depends on whether or not `widget` is current viewable. If it is, then this function updates as necessory the geometry of `widget` and updates the display. If `widget` is not currently viewable, the behavior is the following:

- If `widget` is a toplevel widget, then its window is remapped.

- If `widget` is not a toplevel widget, and one ancestor of `widget` is not viewable, then this function does nothing visually.

- If `widget` is not a toplevel widget, and all its ancestors are viewable, then the widget window is remapped.

HTML Documentation Maintainance:`Arturo Espinosa <arturo@nuclecu.unam.mx>`