Function:     GgiColorMenu

Purpose:      Create Ggi menu element for selecting standard PGPLOT colors.

Category:     USER-INTERFACE

File:         ggi.src

Author:       J.P. Terlouw

Use:          
              #include "ggi.h"
              ident menu;
              char *keyword, *message, **labels;

              menu = GgiColorMenu(keyword, message);

                 menu     - '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.

Description:  GgiColorMenu creates a menu element with 15 predefined label
              texts with color names.

              When a menu entry is selected, the element writes the integer
              color index corresponding with the the color name to the
              supplied keyword.

              The label text of the menu button is set to the currently
              selected color.

Updates:      Aug 18, 2000: JPT, Document created.