Function:     GgiDeactivate

Purpose:      Make Ggi element insensitive to user interaction

Category:     USER-INTERFACE

File:         ggi.src

Author:       J.P. Terlouw

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

              result = GgiDeactivate(element);

                 element  -  the element to be operated upon.
                 result   -  receives a copy of the argument.

Description:  GgiDeactivate makes an element insensitive to user interaction.
              This prevents the user to manipulate the element, e.g., when
              such manipulation would be irrelevant or unwantend in the
              present context.
              If a container element (form or shell) is deactivated, all
              elements contained by it will be made insensitive.

Updates:      Jan 13, 1998: JPT, Document created.
              May 13, 1998: JPT, Container element interaction added.