Function:     GgiIsRealized

Purpose:      Check whether element has been realized

Category:     USER-INTERFACE, SYSTEM

File:         ggi.src

Author:       J.P. Terlouw

Use:          
              #include "ggi.h"
              ident  element;
              bool result;

              result = GgiIsRealized(element);


Description:  GgiIsRealized() returns TRUE if the specified element has been
              realized, FALSE if not. The main purpose of this function is
              to check the status of plot fields (and canvasses) in pop-up
              shells. These can only be accessed if they have been
              realized, which is not done before the shell is popped up for
              the first time. Attempting to access an unrealized plot field
              or canvas causes the program to crash.
              
Updates:      Sep 17, 1999: JPT, Document created.