Function            popup_get - get user's choice from a popup menu

  Syntax              int popup_get(struct popup_header *ph);

  Prototype in        menuhk.h

  Remarks             popup_get does the actual prompting the user for
                      input. The following keys can be used to navigate
                      in the menu:

                           Up Arrow       Move select bar up one option
                           Down Arrow     Move select bar down one option
                           Home           Move select bar to first option
                           End            Move select bar to last option
                           ENTER          Select the hilited option
                           ESC            Abort

                      in addition to any cmdkeys.

                      Other actions may be taken before returning from
                      this function, according to the flags for the menu.
                      See popup_alloc() for more details.

  Return value        returns zero if ESC was hit, otherwise returns the
                      number of the command selected. This is not the
                      array index of the command. If command[] has 3
                      static text items and a command, and the command is
                      selected, a 1 will be returned, even though the
                      command is the fourth command with a command index
                      of three (command[3]).

  See also            menuhk.h
                      isHiliteable(), menu_popup(), popup_alloc(),
                      popup_free(), popup_restore(), popup_setcurrent(),
                      pophilite(), popunlite()
                      popuperrno

  Example             see demopop.c