/*
 POPUP.DOX

 License CC0 PUBLIC DOMAIN

 To the extent possible under law, Mark J. Olesen has waived all copyright
 and related or neighboring rights to FDOSTUI Library. This work is published
 from: United States.
*/

/*! \file popup.hpp
\brief common dialog boxes
*/

/*!
\fn unsigned char* popup_input(
    unsigned char const*                i_title,
    unsigned char const*                i_prompt,
    unsigned char const*                i_default)
\brief popup an input dialog
\param[in] i_title string to display in title bar
\param[in] i_prompt description of value to be entered by user
\param[in] i_default default value
\returns 0 user cancelled
\returns !0 buffer containing user input. caller must free.
\see inputdlg
*/

/*!
\fn enum event_response popup_menu(
    struct menuitem *                   io_menu,
    int const                           i_pos_x,
    int const                           i_pos_y)
\brief popup a menu
\param[in,out] io_menu menu to popup
\param[in] i_pos_x x coordinate
\param[in] i_pos_y y coordinate
\returns response
*/

/*!
\fn enum event_response popup_message(
    unsigned char const*                i_title,
    unsigned char const*                i_message)
\brief popup a message
\param[in] i_title window title
\param[in] i_message message
\returns response
*/
