libui/docs/lifetimes.md

Object lifetimes

Know them.

One of the more annoying parts of libui is that it has to juggle an OS control handle and at least one C data structure for a single uiControl, uiParent, uiWindow, etc. To that end, this document exists to lay the ground rules for object lifetimes.

To end programmers

TODO complain loudly if rules broken TODO complain loudly if Destroying a control with a parent

Implementation

Note that control implementations generally don't need to worry about backend-specific information; these are handled by the backends's convenience functions. If you bypass those, however, you will need to worry.

Backend-Agnostic (uiBox, uiGrid)

Windows

TODO write a lifetimes.c

Unix

see os x section TODO write a lifetimes.c

Mac OS X

notes about not monitoring references or destruction here do the whole "keep a reference around" thing TODO drop the deleted controls view