3 * $Id: xgetline.c,v 1.6 1998/12/03 00:56:29 mdw Exp $
5 * Fetch a line of text from the user
7 * (c) 1998 Straylight/Edgeware
10 /*----- Licensing notice --------------------------------------------------*
12 * This file is part of the Edgeware X tools collection.
14 * X tools is free software; you can redistribute it and/or modify
15 * it under the terms of the GNU General Public License as published by
16 * the Free Software Foundation; either version 2 of the License, or
17 * (at your option) any later version.
19 * X tools 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 General Public License for more details.
24 * You should have received a copy of the GNU General Public License
25 * along with X tools; if not, write to the Free Software Foundation,
26 * Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
29 /*----- Revision history --------------------------------------------------*
31 * $Log: xgetline.c,v $
32 * Revision 1.6 1998/12/03 00:56:29 mdw
33 * Set focus on the entry field, rather than leaving things to luck.
35 * Revision 1.5 1998/12/03 00:39:44 mdw
36 * Force focus when starting up.
38 * Revision 1.4 1998/11/30 22:36:47 mdw
39 * Tidy up tabbing in help texts very slightly.
41 * Revision 1.3 1998/11/21 22:30:20 mdw
42 * Support GNU-style long options throughout, and introduce proper help
43 * text to all programs. Update manual pages to match.
45 * Revision 1.2 1998/11/18 21:25:30 mdw
46 * Remove bogus `-h' option from the options list.
48 * Revision 1.1 1998/11/16 23:00:49 mdw
53 /*----- Header files ------------------------------------------------------*/
60 #include <gdk/gdkkeysyms.h>
66 /*----- Main code ---------------------------------------------------------*/
70 * Arguments: @GtkWidget *w@ = widget raising the signal
71 * @gpointer *p@ = pointer to integer result code
75 * Use: Sets the result code to zero (failure) and ends the loop.
78 static void cancel(GtkWidget
*w
, gpointer
*p
)
87 * Arguments: @GtkWidget *w@ = widget raising the signal
88 * @gpointer *p@ = pointer to integer result code
92 * Use: Sets the result code nonzero (success) and ends the loop.
95 static void done(GtkWidget
*w
, gpointer
*p
)
102 /* --- @check_escape@ --- *
104 * Arguments: @GtkWidget *w@ = widget raising the signal
105 * @GdkEventKey *ev@ = pointer to event data
106 * @gpointer *p@ = widget to activate in response
110 * Use: Activates a widget when an escape keypress is detected.
113 static gboolean
check_escape(GtkWidget
*w
, GdkEventKey
*ev
, gpointer
*p
)
115 if (ev
->keyval
== GDK_Escape
) {
117 gtk_widget_activate(GTK_WIDGET(p
));
119 gtk_object_destroy(GTK_OBJECT(w
));
125 /* --- @version@ --- *
127 * Arguments: @FILE *fp@ = output stream to print the message on
131 * Use: Spits out a version message.
134 static void version(FILE *fp
)
136 fprintf(fp
, "%s (xtoys version " VERSION
")\n", QUIS
);
141 * Arguments: @FILE *fp@ = output stream to print the message on
145 * Use: Spits out a usage message.
148 static void usage(FILE *fp
)
150 fprintf(fp
, "Usage: %s [-i] [-t title] [-p prompt] [-d default]\n", QUIS
);
155 * Arguments: @int argc@ = number of command line arguments
156 * @char *argv[]@ = addresses of arguments
158 * Returns: Zero if OK, and we read a string; nonzero if the user
161 * Use: Reads a string from the user, and returns it on standard
165 int main(int argc
, char *argv
[])
167 /* --- Configuration variables --- */
171 char *title
= "Input request";
181 /* --- User interface bits --- */
188 /* --- Crank up the toolkit --- *
190 * Have to do this here: GTK snarfs some command line options which my
191 * parser would barf about.
195 gtk_init(&argc
, &argv
);
197 /* --- Parse options from command line --- */
201 /* --- Long options structure --- */
203 static struct option opt
[] = {
204 { "help", 0, 0, 'h' },
205 { "usage", 0, 0, 'u' },
206 { "version", 0, 0, 'v' },
207 { "title", required_argument
, 0, 't' },
208 { "prompt", required_argument
, 0, 'p' },
209 { "default", required_argument
, 0, 'd' },
210 { "password", 0, 0, 'i' },
211 { "invisible", 0, 0, 'i' },
216 /* --- Fetch an option --- */
218 i
= getopt_long(argc
, argv
, "huv t:p:d:i", opt
, 0);
222 /* --- Work out what to do with it --- */
231 "Pops up a small window requesting input from a user, and echoes the\n"
232 "response to stdout, where it can be collected by a shell script.\n"
234 "Options available are:\n"
236 "-h, --help Display this help text\n"
237 "-u, --usage Display a short usage summary\n"
238 "-v, --version Display the program's version number\n"
240 "-i, --invisible\t Don't show the user's string as it's typed\n"
241 "-t, --title=TITLE Set the window's title string\n"
242 "-p, --prompt=PROMPT Set the window's prompt string\n"
243 "-d, --default=DEFAULT Set the default string already in the window\n",
279 /* --- Create the main window --- */
281 win
= gtk_window_new(GTK_WINDOW_TOPLEVEL
);
282 gtk_window_set_title(GTK_WINDOW(win
), title
);
283 gtk_window_position(GTK_WINDOW(win
), GTK_WIN_POS_MOUSE
);
284 gtk_signal_connect(GTK_OBJECT(win
), "destroy",
285 GTK_SIGNAL_FUNC(cancel
), &ok
);
287 /* --- Create the box for laying out the widgets inside --- */
289 left
= (prompt ?
1 : 0);
290 box
= gtk_table_new(left
+ 2, 1, 0);
292 /* --- Maybe create a prompt widget --- */
295 GtkWidget
*w
= gtk_label_new(prompt
);
296 gtk_table_attach(GTK_TABLE(box
), w
,
297 0, 1, 0, 1, 0, GTK_EXPAND
, 4, 2);
301 /* --- Create the entry widget --- */
303 entry
= gtk_entry_new();
304 gtk_entry_set_text(GTK_ENTRY(entry
), dfl
);
305 gtk_table_attach(GTK_TABLE(box
), entry
,
306 left
, left
+ 1, 0, 1,
307 GTK_EXPAND
| GTK_FILL
, GTK_EXPAND
, 4, 2);
309 gtk_entry_set_visibility(GTK_ENTRY(entry
), FALSE
);
310 gtk_widget_show(entry
);
312 /* --- Create the default action widget --- */
314 btn
= gtk_button_new_with_label("OK");
315 gtk_table_attach(GTK_TABLE(box
), btn
,
316 left
+ 1, left
+ 2, 0, 1, 0, GTK_EXPAND
, 2, 2);
317 GTK_WIDGET_SET_FLAGS(btn
, GTK_CAN_DEFAULT
);
318 gtk_widget_show(btn
);
320 /* --- Add the box into the main window --- */
322 gtk_container_add(GTK_CONTAINER(win
), box
);
323 gtk_widget_show(box
);
325 /* --- Last minute configuration things --- */
327 gtk_widget_grab_default(btn
);
328 gtk_signal_connect(GTK_OBJECT(btn
), "clicked",
329 GTK_SIGNAL_FUNC(done
), &ok
);
330 gtk_signal_connect_object(GTK_OBJECT(entry
), "activate",
331 GTK_SIGNAL_FUNC(gtk_widget_activate
),
333 gtk_signal_connect(GTK_OBJECT(win
), "key_press_event",
334 GTK_SIGNAL_FUNC(check_escape
), 0);
336 /* --- Go go go --- */
338 gtk_widget_realize(win
);
340 gtk_widget_grab_focus(entry
);
341 gtk_widget_show(win
);
344 /* --- Output the result --- */
347 char *p
= gtk_entry_get_text(GTK_ENTRY(entry
));
351 return (ok ? EXIT_SUCCESS
: EXIT_FAILURE
);
354 /*----- That's all, folks -------------------------------------------------*/