Function:     GgiSetCleanup

Purpose:      Set a Ggi element's post-delete cleanup method.

Category:     USER-INTERFACE

File:         ggi.src

Author:       J.P. Terlouw

Use:
              #include "ggi.h"
              ident element, result;
              void  *arg;
              GgiCleanupProc proc;

              result = GgiSetCleanup(element, proc, arg);

                 element  -  the element to be operated upon.
                 proc     -  pointer to cleanup function.
                 arg      -  argument to cleanup function.
                 result   -  copy of 'element'.

Description:  This function registers a callback function to be called
              when an element is deleted. Function prototype:

                 void proc(void*)

              A cleanup callback can be useful in cases when there are
              objects associated with the element wich must be dealt with
              when the element is deleted. Examples of such objects are
              dynamically allocated memory, other Ggi elements, keyword
              handlers, etc.

Updates:      Jul  5, 2000: JPT, Document created.