0fdb8caae7941557cddb22c4fd3d732d48f484ee
[pspp-builds.git] / src / ui / gui / widget-io.h
1 /* PSPPIRE - a graphical user interface for PSPP.
2    Copyright (C) 2007  Free Software Foundation
3
4    This program is free software: you can redistribute it and/or modify
5    it under the terms of the GNU General Public License as published by
6    the Free Software Foundation, either version 3 of the License, or
7    (at your option) any later version.
8
9    This program is distributed in the hope that it will be useful,
10    but WITHOUT ANY WARRANTY; without even the implied warranty of
11    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
12    GNU General Public License for more details.
13
14    You should have received a copy of the GNU General Public License
15    along with this program.  If not, see <http://www.gnu.org/licenses/>. */
16
17 #include <gtk/gtk.h>
18
19
20 /* Returns a string generated from FMT and a list of GtkEntry widgets.
21    Each conversion in FMT will be replaced with the text from the
22    corresponding GtkEntry.  The normal printf semantics will be ignored.
23    Note that the GtkEntry widgets may be GtkSpinbuttons or any other widget
24    derived from GtkEntry.
25    The returned string should be freed when no longer required.
26  */
27 gchar * widget_printf (const gchar *fmt, ...);
28
29 /*
30    Returns a GtkHBox populated with an GtkLabel and GtkEntry widgets.
31    Each conversion in FMT will cause a GtkEntry (possibly a GtkSpinButton) to
32    be created.  Any text between conversions produces a GtkLabel.
33    There should be N arguments following FMT should be of type GtkEntry **,
34    where N is the number of conversions.
35    These arguments will be filled with a pointer to the corresponding widgets.
36    Their properties may be changed, but they should not be unrefed.
37  */
38 GtkWidget *widget_scanf (const gchar *fmt, ...);