3 * $Id: msg.h,v 1.4 1999/05/06 19:51:48 mdw Exp $
5 * Display a message and get an answer
7 * (c) 1998 Straylight/Edgeware
10 /*----- Licensing notice --------------------------------------------------*
12 * This file is part of the mgLib GTK utilities library.
14 * mgLib is free software; you can redistribute it and/or modify
15 * it under the terms of the GNU Library General Public License as
16 * published by the Free Software Foundation; either version 2 of the
17 * License, or (at your option) any later version.
19 * mgLib is distributed in the hope that it will be useful,
20 * but WITHOUT ANY WARRANTY; without even the implied warranty of
21 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
22 * GNU Library General Public License for more details.
24 * You should have received a copy of the GNU Library General Public
25 * License along with mgLib; if not, write to the Free
26 * Software Foundation, Inc., 59 Temple Place - Suite 330, Boston,
30 /*----- Revision history --------------------------------------------------*
33 * Revision 1.4 1999/05/06 19:51:48 mdw
34 * Reformatted the LGPL notice a little bit.
36 * Revision 1.3 1999/05/05 18:52:45 mdw
37 * Change licensing conditions to LGPL.
39 * Revision 1.2 1999/04/29 20:48:13 mdw
40 * Add documentation for `msg'.
42 * Revision 1.1 1998/12/11 09:44:21 mdw
54 /*----- Header files ------------------------------------------------------*/
58 /*----- Functions provided ------------------------------------------------*/
62 * Arguments: @char *buttons@ = the button strings to display
63 * @char *msg@ = the message skeleton string
65 * Returns: Index of the button selected.
67 * Use: Displays a message to the user in a nice dialogue box and
68 * returns the index of the button selected.
70 * The @msg@ argument is a @printf@-style format string, which
71 * contains the message to actually be shown. The @buttons@
72 * argument is a comma-separated list of buttons to be drawn,
73 * from right to left. A button name can be preceded with `:'
74 * to indicate that it's the default, or `~' if it's the
75 * `cancel' button. The return value is the zero-based index
76 * of the button selected.
79 extern int msg(const char */
*buttons*/
, const char */
*msg*/
, ...);
81 /*----- That's all, folks -------------------------------------------------*/