Function:     GgiUseShell

Purpose:      Use shell, form or viewport as container for new elements

Category:     USER-INTERFACE

File:         ggi.src

Author:       J.P. Terlouw

Use:          
              #include "ggi.h"
              ident shell, result;
              char *name;

              result = GgiUseShell(shell);

                 result  -  the container element previously used
                 shell   -  shell, form or viewport element or NULL if new
                            elements should be created in the main window again.

Description:  GgiUseShell causes new elements to be placed in the specified
              container element. To revert to the main window, the argument NULL
              can be used. If a container element is to be deleted, all elements
              contained by it must be deleted first.

Related documents:
              GgiShell.dc2, GgiForm.dc2, GgiShowShell.dc2

Updates:      Mar 31, 1998: JPT, Document created.
              May 13, 1998: JPT, Form element added
              Nov  2, 1999: JPT, Viewport element added.