//docs/MPGui.doc/SyncMPGuiRequest

   NAME   
  SyncMPGuiRequest -- Displays and processes an MPGui. (V3)

   SYNOPSIS
  result = SyncMPGuiRequest( fname, gh)
  D0                         A0     A1

  char * SyncMPGuiRequest( char *, struct MPGuiHandle *);

   FUNCTION
  Displays an MPGuiHandle allocated by AllocMPGuiHandle() and processes all
  messages.

   INPUTS
  fname - name of file describing gui.
  gh    - MPGuiHandle allocated by AllocMPGuiHandle().

   RESULT
  Attributes of the MPGui if Save/Use/Ok was used.
  0 if Cancel was used/window closed/Esc pressed.
  -1 for error. Use MPGuiError() to get error.

   EXAMPLE

   NOTES
  If MPG_PREFS was supplied to AllocMPGuiHandle() then use MPGuiResponse()
  to determine if Save or Use was pressed.

  If the requester will not fit in one column with the default screen font
  then it falls back in the following order until it fits:

    Compressed vertical seperation;
    Default fixed font;
    Default fixed font with compressed vertical seperation;
    Topaz 80;
    Topaz 80 with compressed vertical seperation;
    Two columns topaz 80 with compressed vertical seperation;
    3 or more columns topaz 80 with compressed vertical seperation.

   BUGS
  When trying to cope with very small screens/very large requesters it can
  result in gadgets with negative width which can crash the system. This
  should only happen if more than 2 columns are required.

  Fixed in version 5.1 Buttons with no Title going to a new column

   SEE ALSO
  AllocMPGuiHandleA(),MPGuiError(),MPGuiResponse().