Function:     GgiProgress

Purpose:      Create a Ggi progress bar

Category:     USER-INTERFACE

File:         ggi.src

Author:       J.P. Terlouw

Use:          
              #include "ggi.h"
              ident progress;
              char *keyword, *message;
              int   length;

              progress = GgiProgress(keyword, message, length);

                 progress -  'handle' by which element can be referenced.
                 keyword  -  user input keyword.
                 message  -  help text which pops up when the pointer stays
                             in the input area for some time.
                 length   -  element's length in pixels.

Description:  GgiProgress creates a progress bar.
              On the screen is consists of a rectangular bar which reflects
              the value of the associated user input keyword.
              This keyword is in fact not meant to be set by the user,
              but it should be set by the program uing WKEY. The value
              should be in the range 0.0 - 1.0.
              
Updates:      Jul  1, 1999: JPT, Document created.