Function:     GgiSetBitmap

Purpose:      Specify a bitmap for a Ggi element's label.

Category:     USER-INTERFACE

File:         ggi.src

Author:       J.P. Terlouw

Use:
              #include "ggi.h"
              ident element, result;
              int   width, height;
              char  *bits;

              result = GgiSetBitmap(element, width, heigth, bits);

                 element  -  the element to be operated upon.
                 width    -  bitmap's width in pixels.
                 height   -  bitmap's height in pixels.
                 bits     -  the bitmap's bits.
                 result   -  receives a copy the argument.

Description:  This function currently operates on elements created by GgiLabel
              or GgiButton. As necessary it will be extended to other elements
              containing a label.

Updates:      Mar 25, 1998: JPT, Document created.
              Nov 25, 1999: JPT, Support added for GgiButton element.