2 * GTK - The GIMP Toolkit
3 * Copyright (C) 1999 Red Hat, Inc.
4 * Copyright (C) 2002 Anders Carlsson <andersca@gnu.org>
5 * Copyright (C) 2003 Matthias Clasen <mclasen@redhat.com>
6 * Copyright (C) 2005 Carlos Garnacho Parro <carlosg@gnome.org>
10 * This library is free software; you can redistribute it and/or
11 * modify it under the terms of the GNU Lesser General Public
12 * License as published by the Free Software Foundation; either
13 * version 2 of the License, or (at your option) any later version.
15 * This library is distributed in the hope that it will be useful,
16 * but WITHOUT ANY WARRANTY; without even the implied warranty of
17 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
18 * Lesser General Public License for more details.
20 * You should have received a copy of the GNU Lesser General Public
21 * License along with this library; if not, write to the
22 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
23 * Boston, MA 02111-1307, USA.
29 get_test_page (const gchar *text)
31 return gtk_label_new (text);
35 GtkAssistant *assistant;
40 complete_cb (GtkWidget *check,
43 PageData *pdata = data;
46 complete = gtk_toggle_button_get_active (GTK_TOGGLE_BUTTON (check));
48 gtk_assistant_set_page_complete (pdata->assistant,
55 add_completion_test_page (GtkWidget *assistant,
64 page = gtk_vbox_new (0, FALSE);
65 check = gtk_check_button_new_with_label ("Complete");
67 gtk_container_add (GTK_CONTAINER (page), gtk_label_new (text));
68 gtk_container_add (GTK_CONTAINER (page), check);
70 gtk_toggle_button_set_active (GTK_TOGGLE_BUTTON (check), complete);
72 pdata = g_new (PageData, 1);
73 pdata->assistant = GTK_ASSISTANT (assistant);
75 g_signal_connect (G_OBJECT (check), "toggled",
76 G_CALLBACK (complete_cb), pdata);
80 gtk_widget_show_all (page);
82 gtk_assistant_append_page (GTK_ASSISTANT (assistant), page);
83 gtk_assistant_set_page_title (GTK_ASSISTANT (assistant), page, text);
84 gtk_assistant_set_page_complete (GTK_ASSISTANT (assistant), page, complete);
88 cancel_callback (GtkWidget *widget)
92 gtk_widget_hide (widget);
96 close_callback (GtkWidget *widget)
100 gtk_widget_hide (widget);
104 apply_callback (GtkWidget *widget)
110 progress_timeout (GtkWidget *assistant)
112 GtkWidget *page, *progress;
116 current_page = gtk_assistant_get_current_page (GTK_ASSISTANT (assistant));
117 page = gtk_assistant_get_nth_page (GTK_ASSISTANT (assistant), current_page);
118 progress = GTK_BIN (page)->child;
120 value = gtk_progress_bar_get_fraction (GTK_PROGRESS_BAR (progress));
122 gtk_progress_bar_set_fraction (GTK_PROGRESS_BAR (progress), value);
126 gtk_assistant_set_page_complete (GTK_ASSISTANT (assistant), page, TRUE);
134 prepare_callback (GtkWidget *widget, GtkWidget *page)
136 if (GTK_IS_LABEL (page))
137 g_print ("prepare: %s\n", gtk_label_get_text (GTK_LABEL (page)));
138 else if (gtk_assistant_get_page_type (GTK_ASSISTANT (widget), page) == GTK_ASSISTANT_PAGE_PROGRESS)
142 progress = GTK_BIN (page)->child;
143 gtk_assistant_set_page_complete (GTK_ASSISTANT (widget), page, FALSE);
144 gtk_progress_bar_set_fraction (GTK_PROGRESS_BAR (progress), 0.0);
145 g_timeout_add (300, (GSourceFunc) progress_timeout, widget);
148 g_print ("prepare: %d\n", gtk_assistant_get_current_page (GTK_ASSISTANT (widget)));
152 create_simple_assistant (GtkWidget *widget)
154 static GtkWidget *assistant = NULL;
160 assistant = gtk_assistant_new ();
161 gtk_window_set_default_size (GTK_WINDOW (assistant), 400, 300);
163 g_signal_connect (G_OBJECT (assistant), "cancel",
164 G_CALLBACK (cancel_callback), NULL);
165 g_signal_connect (G_OBJECT (assistant), "close",
166 G_CALLBACK (close_callback), NULL);
167 g_signal_connect (G_OBJECT (assistant), "apply",
168 G_CALLBACK (apply_callback), NULL);
169 g_signal_connect (G_OBJECT (assistant), "prepare",
170 G_CALLBACK (prepare_callback), NULL);
172 page = get_test_page ("Page 1");
173 gtk_widget_show (page);
174 gtk_assistant_append_page (GTK_ASSISTANT (assistant), page);
175 gtk_assistant_set_page_title (GTK_ASSISTANT (assistant), page, "Page 1");
176 gtk_assistant_set_page_complete (GTK_ASSISTANT (assistant), page, TRUE);
178 page = get_test_page ("Page 2");
179 gtk_widget_show (page);
180 gtk_assistant_append_page (GTK_ASSISTANT (assistant), page);
181 gtk_assistant_set_page_title (GTK_ASSISTANT (assistant), page, "Page 2");
182 gtk_assistant_set_page_type (GTK_ASSISTANT (assistant), page, GTK_ASSISTANT_PAGE_CONFIRM);
183 gtk_assistant_set_page_complete (GTK_ASSISTANT (assistant), page, TRUE);
186 if (!GTK_WIDGET_VISIBLE (assistant))
187 gtk_widget_show (assistant);
190 gtk_widget_destroy (assistant);
196 create_generous_assistant (GtkWidget *widget)
198 static GtkWidget *assistant = NULL;
204 assistant = gtk_assistant_new ();
205 gtk_window_set_default_size (GTK_WINDOW (assistant), 400, 300);
207 g_signal_connect (G_OBJECT (assistant), "cancel",
208 G_CALLBACK (cancel_callback), NULL);
209 g_signal_connect (G_OBJECT (assistant), "close",
210 G_CALLBACK (close_callback), NULL);
211 g_signal_connect (G_OBJECT (assistant), "apply",
212 G_CALLBACK (apply_callback), NULL);
213 g_signal_connect (G_OBJECT (assistant), "prepare",
214 G_CALLBACK (prepare_callback), NULL);
216 page = get_test_page ("Introduction");
217 gtk_widget_show (page);
218 gtk_assistant_append_page (GTK_ASSISTANT (assistant), page);
219 gtk_assistant_set_page_title (GTK_ASSISTANT (assistant), page, "Introduction");
220 gtk_assistant_set_page_type (GTK_ASSISTANT (assistant), page, GTK_ASSISTANT_PAGE_INTRO);
221 gtk_assistant_set_page_complete (GTK_ASSISTANT (assistant), page, TRUE);
223 add_completion_test_page (assistant, "Content", TRUE, FALSE);
224 add_completion_test_page (assistant, "More Content", TRUE, TRUE);
225 add_completion_test_page (assistant, "Even More Content", TRUE, TRUE);
227 page = get_test_page ("Confirmation");
228 gtk_widget_show (page);
229 gtk_assistant_append_page (GTK_ASSISTANT (assistant), page);
230 gtk_assistant_set_page_title (GTK_ASSISTANT (assistant), page, "Confirmation");
231 gtk_assistant_set_page_type (GTK_ASSISTANT (assistant), page, GTK_ASSISTANT_PAGE_CONFIRM);
232 gtk_assistant_set_page_complete (GTK_ASSISTANT (assistant), page, TRUE);
234 page = gtk_alignment_new (0.5, 0.5, 0.9, 0.0);
235 gtk_container_add (GTK_CONTAINER (page), gtk_progress_bar_new ());
236 gtk_widget_show_all (page);
237 gtk_assistant_append_page (GTK_ASSISTANT (assistant), page);
238 gtk_assistant_set_page_title (GTK_ASSISTANT (assistant), page, "Progress");
239 gtk_assistant_set_page_type (GTK_ASSISTANT (assistant), page, GTK_ASSISTANT_PAGE_PROGRESS);
241 page = get_test_page ("Summary");
242 gtk_widget_show (page);
243 gtk_assistant_append_page (GTK_ASSISTANT (assistant), page);
244 gtk_assistant_set_page_title (GTK_ASSISTANT (assistant), page, "Summary");
245 gtk_assistant_set_page_type (GTK_ASSISTANT (assistant), page, GTK_ASSISTANT_PAGE_SUMMARY);
246 gtk_assistant_set_page_complete (GTK_ASSISTANT (assistant), page, TRUE);
249 if (!GTK_WIDGET_VISIBLE (assistant))
250 gtk_widget_show (assistant);
253 gtk_widget_destroy (assistant);
258 static gchar selected_branch = 'A';
261 select_branch (GtkWidget *widget, gchar branch)
263 selected_branch = branch;
267 nonlinear_assistant_forward_page (gint current_page, gpointer data)
269 switch (current_page)
272 if (selected_branch == 'A')
285 create_nonlinear_assistant (GtkWidget *widget)
287 static GtkWidget *assistant = NULL;
291 GtkWidget *page, *button;
293 assistant = gtk_assistant_new ();
294 gtk_window_set_default_size (GTK_WINDOW (assistant), 400, 300);
296 g_signal_connect (G_OBJECT (assistant), "cancel",
297 G_CALLBACK (cancel_callback), NULL);
298 g_signal_connect (G_OBJECT (assistant), "close",
299 G_CALLBACK (close_callback), NULL);
300 g_signal_connect (G_OBJECT (assistant), "apply",
301 G_CALLBACK (apply_callback), NULL);
302 g_signal_connect (G_OBJECT (assistant), "prepare",
303 G_CALLBACK (prepare_callback), NULL);
305 gtk_assistant_set_forward_page_func (GTK_ASSISTANT (assistant),
306 nonlinear_assistant_forward_page,
309 page = gtk_vbox_new (FALSE, 6);
311 button = gtk_radio_button_new_with_label (NULL, "branch A");
312 gtk_box_pack_start (GTK_BOX (page), button, FALSE, FALSE, 0);
313 g_signal_connect (G_OBJECT (button), "toggled", G_CALLBACK (select_branch), GINT_TO_POINTER ('A'));
314 gtk_toggle_button_set_active (GTK_TOGGLE_BUTTON (button), TRUE);
316 button = gtk_radio_button_new_with_label (gtk_radio_button_get_group (GTK_RADIO_BUTTON (button)),
318 gtk_box_pack_start (GTK_BOX (page), button, FALSE, FALSE, 0);
319 g_signal_connect (G_OBJECT (button), "toggled", G_CALLBACK (select_branch), GINT_TO_POINTER ('B'));
321 gtk_widget_show_all (page);
322 gtk_assistant_append_page (GTK_ASSISTANT (assistant), page);
323 gtk_assistant_set_page_title (GTK_ASSISTANT (assistant), page, "Page 1");
324 gtk_assistant_set_page_complete (GTK_ASSISTANT (assistant), page, TRUE);
326 page = get_test_page ("Page 2A");
327 gtk_widget_show (page);
328 gtk_assistant_append_page (GTK_ASSISTANT (assistant), page);
329 gtk_assistant_set_page_title (GTK_ASSISTANT (assistant), page, "Page 2A");
330 gtk_assistant_set_page_complete (GTK_ASSISTANT (assistant), page, TRUE);
332 page = get_test_page ("Page 2B");
333 gtk_widget_show (page);
334 gtk_assistant_append_page (GTK_ASSISTANT (assistant), page);
335 gtk_assistant_set_page_title (GTK_ASSISTANT (assistant), page, "Page 2B");
336 gtk_assistant_set_page_complete (GTK_ASSISTANT (assistant), page, TRUE);
338 page = get_test_page ("Confirmation");
339 gtk_widget_show (page);
340 gtk_assistant_append_page (GTK_ASSISTANT (assistant), page);
341 gtk_assistant_set_page_title (GTK_ASSISTANT (assistant), page, "Confirmation");
342 gtk_assistant_set_page_type (GTK_ASSISTANT (assistant), page, GTK_ASSISTANT_PAGE_CONFIRM);
343 gtk_assistant_set_page_complete (GTK_ASSISTANT (assistant), page, TRUE);
346 if (!GTK_WIDGET_VISIBLE (assistant))
347 gtk_widget_show (assistant);
350 gtk_widget_destroy (assistant);
356 looping_assistant_forward_page (gint current_page, gpointer data)
358 switch (current_page)
368 GtkAssistant *assistant;
371 assistant = (GtkAssistant*) data;
372 page = gtk_assistant_get_nth_page (assistant, current_page);
374 if (gtk_toggle_button_get_active (GTK_TOGGLE_BUTTON (page)))
386 create_looping_assistant (GtkWidget *widget)
388 static GtkWidget *assistant = NULL;
394 assistant = gtk_assistant_new ();
395 gtk_window_set_default_size (GTK_WINDOW (assistant), 400, 300);
397 g_signal_connect (G_OBJECT (assistant), "cancel",
398 G_CALLBACK (cancel_callback), NULL);
399 g_signal_connect (G_OBJECT (assistant), "close",
400 G_CALLBACK (close_callback), NULL);
401 g_signal_connect (G_OBJECT (assistant), "apply",
402 G_CALLBACK (apply_callback), NULL);
403 g_signal_connect (G_OBJECT (assistant), "prepare",
404 G_CALLBACK (prepare_callback), NULL);
406 gtk_assistant_set_forward_page_func (GTK_ASSISTANT (assistant),
407 looping_assistant_forward_page,
410 page = get_test_page ("Introduction");
411 gtk_widget_show (page);
412 gtk_assistant_append_page (GTK_ASSISTANT (assistant), page);
413 gtk_assistant_set_page_title (GTK_ASSISTANT (assistant), page, "Introduction");
414 gtk_assistant_set_page_type (GTK_ASSISTANT (assistant), page, GTK_ASSISTANT_PAGE_INTRO);
415 gtk_assistant_set_page_complete (GTK_ASSISTANT (assistant), page, TRUE);
417 page = get_test_page ("Content");
418 gtk_widget_show (page);
419 gtk_assistant_append_page (GTK_ASSISTANT (assistant), page);
420 gtk_assistant_set_page_title (GTK_ASSISTANT (assistant), page, "Content");
421 gtk_assistant_set_page_complete (GTK_ASSISTANT (assistant), page, TRUE);
423 page = get_test_page ("More content");
424 gtk_widget_show (page);
425 gtk_assistant_append_page (GTK_ASSISTANT (assistant), page);
426 gtk_assistant_set_page_title (GTK_ASSISTANT (assistant), page, "More content");
427 gtk_assistant_set_page_complete (GTK_ASSISTANT (assistant), page, TRUE);
429 page = gtk_check_button_new_with_label ("Loop?");
430 gtk_widget_show (page);
431 gtk_assistant_append_page (GTK_ASSISTANT (assistant), page);
432 gtk_assistant_set_page_title (GTK_ASSISTANT (assistant), page, "Loop?");
433 gtk_assistant_set_page_complete (GTK_ASSISTANT (assistant), page, TRUE);
435 page = get_test_page ("Confirmation");
436 gtk_widget_show (page);
437 gtk_assistant_append_page (GTK_ASSISTANT (assistant), page);
438 gtk_assistant_set_page_title (GTK_ASSISTANT (assistant), page, "Confirmation");
439 gtk_assistant_set_page_type (GTK_ASSISTANT (assistant), page, GTK_ASSISTANT_PAGE_CONFIRM);
440 gtk_assistant_set_page_complete (GTK_ASSISTANT (assistant), page, TRUE);
443 if (!GTK_WIDGET_VISIBLE (assistant))
444 gtk_widget_show (assistant);
447 gtk_widget_destroy (assistant);
453 create_full_featured_assistant (GtkWidget *widget)
455 static GtkWidget *assistant = NULL;
459 GtkWidget *page, *button;
462 assistant = gtk_assistant_new ();
463 gtk_window_set_default_size (GTK_WINDOW (assistant), 400, 300);
465 button = gtk_button_new_from_stock (GTK_STOCK_STOP);
466 gtk_widget_show (button);
467 gtk_assistant_add_action_widget (GTK_ASSISTANT (assistant), button);
469 g_signal_connect (G_OBJECT (assistant), "cancel",
470 G_CALLBACK (cancel_callback), NULL);
471 g_signal_connect (G_OBJECT (assistant), "close",
472 G_CALLBACK (close_callback), NULL);
473 g_signal_connect (G_OBJECT (assistant), "apply",
474 G_CALLBACK (apply_callback), NULL);
475 g_signal_connect (G_OBJECT (assistant), "prepare",
476 G_CALLBACK (prepare_callback), NULL);
478 page = get_test_page ("Page 1");
479 gtk_widget_show (page);
480 gtk_assistant_append_page (GTK_ASSISTANT (assistant), page);
481 gtk_assistant_set_page_title (GTK_ASSISTANT (assistant), page, "Page 1");
482 gtk_assistant_set_page_complete (GTK_ASSISTANT (assistant), page, TRUE);
484 /* set a side image */
485 pixbuf = gtk_widget_render_icon (page, GTK_STOCK_DIALOG_WARNING, GTK_ICON_SIZE_DIALOG, NULL);
486 gtk_assistant_set_page_side_image (GTK_ASSISTANT (assistant), page, pixbuf);
488 /* set a header image */
489 pixbuf = gtk_widget_render_icon (page, GTK_STOCK_DIALOG_INFO, GTK_ICON_SIZE_DIALOG, NULL);
490 gtk_assistant_set_page_header_image (GTK_ASSISTANT (assistant), page, pixbuf);
492 page = get_test_page ("Invisible page");
493 gtk_assistant_append_page (GTK_ASSISTANT (assistant), page);
495 page = get_test_page ("Page 3");
496 gtk_widget_show (page);
497 gtk_assistant_append_page (GTK_ASSISTANT (assistant), page);
498 gtk_assistant_set_page_title (GTK_ASSISTANT (assistant), page, "Page 3");
499 gtk_assistant_set_page_type (GTK_ASSISTANT (assistant), page, GTK_ASSISTANT_PAGE_CONFIRM);
500 gtk_assistant_set_page_complete (GTK_ASSISTANT (assistant), page, TRUE);
502 /* set a header image */
503 pixbuf = gtk_widget_render_icon (page, GTK_STOCK_DIALOG_INFO, GTK_ICON_SIZE_DIALOG, NULL);
504 gtk_assistant_set_page_header_image (GTK_ASSISTANT (assistant), page, pixbuf);
507 if (!GTK_WIDGET_VISIBLE (assistant))
508 gtk_widget_show (assistant);
511 gtk_widget_destroy (assistant);
518 void (*func) (GtkWidget *widget);
521 { "simple assistant", create_simple_assistant },
522 { "generous assistant", create_generous_assistant },
523 { "nonlinear assistant", create_nonlinear_assistant },
524 { "looping assistant", create_looping_assistant },
525 { "full featured assistant", create_full_featured_assistant },
529 main (int argc, gchar *argv[])
531 GtkWidget *window, *box, *button;
534 gtk_init (&argc, &argv);
536 if (g_getenv ("RTL"))
537 gtk_widget_set_default_direction (GTK_TEXT_DIR_RTL);
539 window = gtk_window_new (GTK_WINDOW_TOPLEVEL);
541 g_signal_connect (G_OBJECT (window), "destroy",
542 G_CALLBACK (gtk_main_quit), NULL);
543 g_signal_connect (G_OBJECT (window), "delete-event",
544 G_CALLBACK (gtk_false), NULL);
546 box = gtk_vbox_new (FALSE, 6);
547 gtk_container_add (GTK_CONTAINER (window), box);
549 for (i = 0; i < G_N_ELEMENTS (buttons); i++)
551 button = gtk_button_new_with_label (buttons[i].text);
554 g_signal_connect (G_OBJECT (button), "clicked",
555 G_CALLBACK (buttons[i].func), NULL);
557 gtk_box_pack_start (GTK_BOX (box), button, TRUE, TRUE, 0);
560 gtk_widget_show_all (window);