Mirrors_UI_SDK/fltk
1
0
Fork 0
mirror of https://github.com/fltk/fltk.git synced 2026-06-02 15:46:52 +08:00
Code Issues Actions Packages Projects Releases Wiki Activity

Docs for fl_choice() clarify argument order, added missing image for one of the examples.

Browse Source 
git-svn-id: file:///fltk/svn/fltk/branches/branch-1.4@12847 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
This commit is contained in:
Greg Ercolano
2018-04-18 09:52:00 +00:00
parent 2bae646a3c
commit 6ada360174
2 changed files with 21 additions and 6 deletions
Download Patch File Download Diff File Expand all files Collapse all files
documentation/src/fl_choice_three_fmt.png
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 1.5 KiB

src/fl_ask.cxx
+21 -6
View File
@@ -363,12 +363,27 @@ int fl_ask(const char *fmt, ...) {
/** Shows a dialog displaying the printf style \p fmt message, /** Shows a dialog displaying the printf style \p fmt message,
this dialog features up to 3 customizable choice buttons this dialog features up to 3 customizable choice buttons
which are specified in *right-to-left* order, e.g.
\code
//
// ______________________________________________
// | ___ |
// | | ? | Message text.. |
// | |___| |
// | [Left] [Middle] [Right] |
// |______________________________________________|
//
//
fl_choice("Message text..", "Right", "Middle", "Left");
\endcode
\note Common dialog boxes are application modal. No more than one common dialog box \note Common dialog boxes are application modal. No more than one common dialog box
can be open at any time. Requests for additional dialog boxes are ignored. can be open at any time. Requests for additional dialog boxes are ignored.
\note \#include <FL/fl_ask.H> \note \#include <FL/fl_ask.H>
Three choices with printf() style formatting: Three choices with printf() style formatting:
\image html fl_choice_three_fmt.png
\image latex fl_choice_three_fmt.png "fl_choice() three choices with printf formatting" width=4cm
\code \code
int num_msgs = GetNumberOfMessages(); int num_msgs = GetNumberOfMessages();
switch ( fl_choice("What to do with %d messages?", "Send", "Save", "Delete", num_msgs) ) { switch ( fl_choice("What to do with %d messages?", "Send", "Save", "Delete", num_msgs) ) {
@@ -408,12 +423,12 @@ int fl_ask(const char *fmt, ...) {
\endcode \endcode
\param[in] fmt can be used as an sprintf-like format and variables for the message text \param[in] fmt can be used as an sprintf-like format and variables for the message text
\param[in] b0 text label of button 0 \param[in] b0 text label for right button 0
\param[in] b1 text label of button 1 (can be 0) \param[in] b1 text label for middle button 1 (can be 0)
\param[in] b2 text label of button 2 (can be 0) \param[in] b2 text label for left button 2 (can be 0)
\retval 0 if the first button with \p b0 text is pushed or another dialog box is still open \retval 0 if the button with \p b0 text is pushed or another dialog box is still open
\retval 1 if the second button with \p b1 text is pushed \retval 1 if the button with \p b1 text is pushed
\retval 2 if the third button with \p b2 text is pushed \retval 2 if the button with \p b2 text is pushed
*/ */
int fl_choice(const char*fmt,const char *b0,const char *b1,const char *b2,...){ int fl_choice(const char*fmt,const char *b0,const char *b1,const char *b2,...){