Function:     GgiDialog

Purpose:      Create a Ggi dialog shell element

Category:     USER-INTERFACE

File:         ggi.src

Author:       J.P. Terlouw

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

              shell = GgiDialog(name);

                 shell   -  'handle' by which element can be referenced.
                 name    -  the shell's name

Description:  GgiDialog creates a dialog shell element.
              A dialog shell element is a more or less independent window
              which can contain any number of 'ordinary' Ggi elements.
              It can be made visible or invisible (popped up or down)
              independent from the main window. Other than 'ordinary' shell
              elements created by GgiShell, interaction is limited to
              a popped-up dialog shell.
              If a dialog element is  deleted, all elements contained by it
              will be deleted automatically.

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

Updates:      Jun 24, 1998: JPT, Document created.
              Mar 24, 1999: JPT, Recursive deletion implemented.