Function:     GgiSetBtnKey

Purpose:      Specify keyword through which mouse button is reported.

Category:     USER-INTERFACE

File:         ggi.src

Author:       J.P. Terlouw

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

              result = GgiSetBtnKey(element, keyword);

                 element  -  the element to be operated upon.
                 keyword  -  the keyword for reporting the mouse button.
                 result   -  receives a copy of the first argument.

Description:  This function currently only operates on the menu element type.
              After the call, the identity of the mouse button used to
              select a menu entry will be written to the specified keyword.
              The button identity is an integer with one of the values
              ggiButn1, ggiButn2 or ggiButn3.

Updates:      Nov  5, 2001: JPT, Document created.