//docs/MPGui.doc/AllocMPGuiHandleA

   NAME   
  AllocMPGuiHandleA -- Allocates an MPGuiHandle. (V3)
  AllocMPGuiHandle -- Varargs version of AllocMPGuiHandleA (V3)

   SYNOPSIS
  gh = AllocMPGuiHandleA(taglist)
  D0                     A0

  struct MPGuiHandle * AllocMPGuiHandleA(struct TagItem *);

  gh = AllocMPGuiHandle(Tag1, ...)

  struct MPGuiHandle * AllocMPGuiHandle(ULONG,...);

   FUNCTION
  Allocates an MPGuiHandle.

   INPUTS
  taglist - pointer to TagItem array.

  Tags are:

  MPG_PUBSCREENNAME - Data is char * name of public screen to use.
                      Default is default public screen.
  MPG_RELMOUSE      - Data is BOOL. TURE to open requester near pointer.
                      Default is FALSE.
  MPG_HELP          - Data is struct Hook *, called with object=char * to
                      help node to be displayed.
  MPG_CHELP         - Call help when gadget changes
  MPG_PARAMS        - Data is char ** array of parameters
  MPG_NEWLINE       - Data is BOOL. TRUE means new line rather than space
                      in output, no "s round files or screen modes.
                      Default is FALSE.
  MPG_PREFS         - Data is BOOL. Default FALSE. TRUE provides
                      _Save/_Use/_Cancel gadgets, Use MPGuiResponse() to
                      get response (1=Save 2=Use), Esc key will not exit.
  MPG_MENUS         - Data is struct NewMenu *.
  MPG_MENUHOOK      - Data is struct Hook *, called with
                      object=struct IntuiMsg *, message = struct Menu *
                      If MPG_HELP is set then called for MENUHELP as well.
                      Return 0 to quit, non 0 to continue.
  MPG_SIGNALS       - Data is ULONG signals to wait for then call hook
                      provided in MPG_SIGNALHOOK.
  MPG_SIGNALHOOK    - Data is struct Hook *, called with
                      object = ULONG signals received,
                      message = ULONG notused
                      Return 0 to quit, non 0 to continue.
  MPG_CHECKMARK     - Data is struct Image * for menu checkmark
  MPG_AMIGAKEY      - Data is struct Image * for menu AmigaKey
  MPG_BUTTONHOOK		- Data is struct Hook *,
                      called with object=struct MPGuiHandle *,
                      message = number of button
                      Return 0 to quit, non 0 to continue.
  MPG_NOBUTTONS     - If set then no buttons are shown, overrides MPG_PREFS.

   RESULT
  gh - Allocated MPGuiHandle.
       NULL on error (no memory).

   EXAMPLE

   NOTES

   BUGS
  The allocated handle has a max size of about 3K for the response.
  The maximum parameter replaced line length is about 2K.
  FONT? gadgets ignore the size at the moment.
  If there are more than 3 BUTTON gadgets in a row then they are left
  justified - should be fully justified.
  Button layout may not yet be correct.

   SEE ALSO
  FreeMPGuiHandle(),MPGuiResponse().