3 * $Id: msg.h,v 1.3 1999/05/05 18:52:45 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 Software
26 * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
29 /*----- Revision history --------------------------------------------------*
32 * Revision 1.3 1999/05/05 18:52:45 mdw
33 * Change licensing conditions to LGPL.
35 * Revision 1.2 1999/04/29 20:48:13 mdw
36 * Add documentation for `msg'.
38 * Revision 1.1 1998/12/11 09:44:21 mdw
50 /*----- Header files ------------------------------------------------------*/
54 /*----- Functions provided ------------------------------------------------*/
58 * Arguments: @char *buttons@ = the button strings to display
59 * @char *msg@ = the message skeleton string
61 * Returns: Index of the button selected.
63 * Use: Displays a message to the user in a nice dialogue box and
64 * returns the index of the button selected.
66 * The @msg@ argument is a @printf@-style format string, which
67 * contains the message to actually be shown. The @buttons@
68 * argument is a comma-separated list of buttons to be drawn,
69 * from right to left. A button name can be preceded with `:'
70 * to indicate that it's the default, or `~' if it's the
71 * `cancel' button. The return value is the zero-based index
72 * of the button selected.
75 extern int msg(const char */*buttons*/, const char */*msg*/, ...);
77 /*----- That's all, folks -------------------------------------------------*/