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,
54 add_completion_test_page (GtkWidget *assistant,
63 page = gtk_vbox_new (0, FALSE);
64 check = gtk_check_button_new_with_label ("Complete");
66 gtk_container_add (GTK_CONTAINER (page), gtk_label_new (text));
67 gtk_container_add (GTK_CONTAINER (page), check);
69 gtk_toggle_button_set_active (GTK_TOGGLE_BUTTON (check), complete);
71 pdata = g_new (PageData, 1);
72 pdata->assistant = GTK_ASSISTANT (assistant);
74 g_signal_connect (G_OBJECT (check), "toggled",
75 G_CALLBACK (complete_cb), pdata);
79 gtk_widget_show_all (page);
81 gtk_assistant_append_page (GTK_ASSISTANT (assistant), page);
82 gtk_assistant_set_page_title (GTK_ASSISTANT (assistant), page, text);
83 gtk_assistant_set_page_complete (GTK_ASSISTANT (assistant), page, complete);
89 cancel_callback (GtkWidget *widget)
93 gtk_widget_hide (widget);
97 close_callback (GtkWidget *widget)
101 gtk_widget_hide (widget);
105 apply_callback (GtkWidget *widget)
111 progress_timeout (GtkWidget *assistant)
113 GtkWidget *page, *progress;
117 current_page = gtk_assistant_get_current_page (GTK_ASSISTANT (assistant));
118 page = gtk_assistant_get_nth_page (GTK_ASSISTANT (assistant), current_page);
119 progress = GTK_BIN (page)->child;
121 value = gtk_progress_bar_get_fraction (GTK_PROGRESS_BAR (progress));
123 gtk_progress_bar_set_fraction (GTK_PROGRESS_BAR (progress), value);
127 gtk_assistant_set_page_complete (GTK_ASSISTANT (assistant), page, TRUE);
135 prepare_callback (GtkWidget *widget, GtkWidget *page)
137 if (GTK_IS_LABEL (page))
138 g_print ("prepare: %s\n", gtk_label_get_text (GTK_LABEL (page)));
139 else if (gtk_assistant_get_page_type (GTK_ASSISTANT (widget), page) == GTK_ASSISTANT_PAGE_PROGRESS)
143 progress = GTK_BIN (page)->child;
144 gtk_assistant_set_page_complete (GTK_ASSISTANT (widget), page, FALSE);
145 gtk_progress_bar_set_fraction (GTK_PROGRESS_BAR (progress), 0.0);
146 gdk_threads_add_timeout (300, (GSourceFunc) progress_timeout, widget);
149 g_print ("prepare: %d\n", gtk_assistant_get_current_page (GTK_ASSISTANT (widget)));
153 create_simple_assistant (GtkWidget *widget)
155 static GtkWidget *assistant = NULL;
161 assistant = gtk_assistant_new ();
162 gtk_window_set_default_size (GTK_WINDOW (assistant), 400, 300);
164 g_signal_connect (G_OBJECT (assistant), "cancel",
165 G_CALLBACK (cancel_callback), NULL);
166 g_signal_connect (G_OBJECT (assistant), "close",
167 G_CALLBACK (close_callback), NULL);
168 g_signal_connect (G_OBJECT (assistant), "apply",
169 G_CALLBACK (apply_callback), NULL);
170 g_signal_connect (G_OBJECT (assistant), "prepare",
171 G_CALLBACK (prepare_callback), NULL);
173 page = get_test_page ("Page 1");
174 gtk_widget_show (page);
175 gtk_assistant_append_page (GTK_ASSISTANT (assistant), page);
176 gtk_assistant_set_page_title (GTK_ASSISTANT (assistant), page, "Page 1");
177 gtk_assistant_set_page_complete (GTK_ASSISTANT (assistant), page, TRUE);
179 page = get_test_page ("Page 2");
180 gtk_widget_show (page);
181 gtk_assistant_append_page (GTK_ASSISTANT (assistant), page);
182 gtk_assistant_set_page_title (GTK_ASSISTANT (assistant), page, "Page 2");
183 gtk_assistant_set_page_type (GTK_ASSISTANT (assistant), page, GTK_ASSISTANT_PAGE_CONFIRM);
184 gtk_assistant_set_page_complete (GTK_ASSISTANT (assistant), page, TRUE);
187 if (!GTK_WIDGET_VISIBLE (assistant))
188 gtk_widget_show (assistant);
191 gtk_widget_destroy (assistant);
197 visible_cb (GtkWidget *check,
200 GtkWidget *page = data;
203 visible = gtk_toggle_button_get_active (GTK_TOGGLE_BUTTON (check));
205 g_object_set (G_OBJECT (page), "visible", visible, NULL);
209 create_generous_assistant (GtkWidget *widget)
211 static GtkWidget *assistant = NULL;
215 GtkWidget *page, *next, *check;
217 assistant = gtk_assistant_new ();
218 gtk_window_set_default_size (GTK_WINDOW (assistant), 400, 300);
220 g_signal_connect (G_OBJECT (assistant), "cancel",
221 G_CALLBACK (cancel_callback), NULL);
222 g_signal_connect (G_OBJECT (assistant), "close",
223 G_CALLBACK (close_callback), NULL);
224 g_signal_connect (G_OBJECT (assistant), "apply",
225 G_CALLBACK (apply_callback), NULL);
226 g_signal_connect (G_OBJECT (assistant), "prepare",
227 G_CALLBACK (prepare_callback), NULL);
229 page = get_test_page ("Introduction");
230 gtk_widget_show (page);
231 gtk_assistant_append_page (GTK_ASSISTANT (assistant), page);
232 gtk_assistant_set_page_title (GTK_ASSISTANT (assistant), page, "Introduction");
233 gtk_assistant_set_page_type (GTK_ASSISTANT (assistant), page, GTK_ASSISTANT_PAGE_INTRO);
234 gtk_assistant_set_page_complete (GTK_ASSISTANT (assistant), page, TRUE);
236 page = add_completion_test_page (assistant, "Content", TRUE, FALSE);
237 next = add_completion_test_page (assistant, "More Content", TRUE, TRUE);
239 check = gtk_check_button_new_with_label ("Next page visible");
240 gtk_toggle_button_set_active (GTK_TOGGLE_BUTTON (check), TRUE);
241 g_signal_connect (G_OBJECT (check), "toggled",
242 G_CALLBACK (visible_cb), next);
243 gtk_widget_show (check);
244 gtk_container_add (GTK_CONTAINER (page), check);
246 add_completion_test_page (assistant, "Even More Content", TRUE, TRUE);
248 page = get_test_page ("Confirmation");
249 gtk_widget_show (page);
250 gtk_assistant_append_page (GTK_ASSISTANT (assistant), page);
251 gtk_assistant_set_page_title (GTK_ASSISTANT (assistant), page, "Confirmation");
252 gtk_assistant_set_page_type (GTK_ASSISTANT (assistant), page, GTK_ASSISTANT_PAGE_CONFIRM);
253 gtk_assistant_set_page_complete (GTK_ASSISTANT (assistant), page, TRUE);
255 page = gtk_alignment_new (0.5, 0.5, 0.9, 0.0);
256 gtk_container_add (GTK_CONTAINER (page), gtk_progress_bar_new ());
257 gtk_widget_show_all (page);
258 gtk_assistant_append_page (GTK_ASSISTANT (assistant), page);
259 gtk_assistant_set_page_title (GTK_ASSISTANT (assistant), page, "Progress");
260 gtk_assistant_set_page_type (GTK_ASSISTANT (assistant), page, GTK_ASSISTANT_PAGE_PROGRESS);
262 page = get_test_page ("Summary");
263 gtk_widget_show (page);
264 gtk_assistant_append_page (GTK_ASSISTANT (assistant), page);
265 gtk_assistant_set_page_title (GTK_ASSISTANT (assistant), page, "Summary");
266 gtk_assistant_set_page_type (GTK_ASSISTANT (assistant), page, GTK_ASSISTANT_PAGE_SUMMARY);
267 gtk_assistant_set_page_complete (GTK_ASSISTANT (assistant), page, TRUE);
270 if (!GTK_WIDGET_VISIBLE (assistant))
271 gtk_widget_show (assistant);
274 gtk_widget_destroy (assistant);
279 static gchar selected_branch = 'A';
282 select_branch (GtkWidget *widget, gchar branch)
284 selected_branch = branch;
288 nonlinear_assistant_forward_page (gint current_page, gpointer data)
290 switch (current_page)
293 if (selected_branch == 'A')
306 create_nonlinear_assistant (GtkWidget *widget)
308 static GtkWidget *assistant = NULL;
312 GtkWidget *page, *button;
314 assistant = gtk_assistant_new ();
315 gtk_window_set_default_size (GTK_WINDOW (assistant), 400, 300);
317 g_signal_connect (G_OBJECT (assistant), "cancel",
318 G_CALLBACK (cancel_callback), NULL);
319 g_signal_connect (G_OBJECT (assistant), "close",
320 G_CALLBACK (close_callback), NULL);
321 g_signal_connect (G_OBJECT (assistant), "apply",
322 G_CALLBACK (apply_callback), NULL);
323 g_signal_connect (G_OBJECT (assistant), "prepare",
324 G_CALLBACK (prepare_callback), NULL);
326 gtk_assistant_set_forward_page_func (GTK_ASSISTANT (assistant),
327 nonlinear_assistant_forward_page,
330 page = gtk_vbox_new (FALSE, 6);
332 button = gtk_radio_button_new_with_label (NULL, "branch A");
333 gtk_box_pack_start (GTK_BOX (page), button, FALSE, FALSE, 0);
334 g_signal_connect (G_OBJECT (button), "toggled", G_CALLBACK (select_branch), GINT_TO_POINTER ('A'));
335 gtk_toggle_button_set_active (GTK_TOGGLE_BUTTON (button), TRUE);
337 button = gtk_radio_button_new_with_label (gtk_radio_button_get_group (GTK_RADIO_BUTTON (button)),
339 gtk_box_pack_start (GTK_BOX (page), button, FALSE, FALSE, 0);
340 g_signal_connect (G_OBJECT (button), "toggled", G_CALLBACK (select_branch), GINT_TO_POINTER ('B'));
342 gtk_widget_show_all (page);
343 gtk_assistant_append_page (GTK_ASSISTANT (assistant), page);
344 gtk_assistant_set_page_title (GTK_ASSISTANT (assistant), page, "Page 1");
345 gtk_assistant_set_page_complete (GTK_ASSISTANT (assistant), page, TRUE);
347 page = get_test_page ("Page 2A");
348 gtk_widget_show (page);
349 gtk_assistant_append_page (GTK_ASSISTANT (assistant), page);
350 gtk_assistant_set_page_title (GTK_ASSISTANT (assistant), page, "Page 2A");
351 gtk_assistant_set_page_complete (GTK_ASSISTANT (assistant), page, TRUE);
353 page = get_test_page ("Page 2B");
354 gtk_widget_show (page);
355 gtk_assistant_append_page (GTK_ASSISTANT (assistant), page);
356 gtk_assistant_set_page_title (GTK_ASSISTANT (assistant), page, "Page 2B");
357 gtk_assistant_set_page_complete (GTK_ASSISTANT (assistant), page, TRUE);
359 page = get_test_page ("Confirmation");
360 gtk_widget_show (page);
361 gtk_assistant_append_page (GTK_ASSISTANT (assistant), page);
362 gtk_assistant_set_page_title (GTK_ASSISTANT (assistant), page, "Confirmation");
363 gtk_assistant_set_page_type (GTK_ASSISTANT (assistant), page, GTK_ASSISTANT_PAGE_CONFIRM);
364 gtk_assistant_set_page_complete (GTK_ASSISTANT (assistant), page, TRUE);
367 if (!GTK_WIDGET_VISIBLE (assistant))
368 gtk_widget_show (assistant);
371 gtk_widget_destroy (assistant);
377 looping_assistant_forward_page (gint current_page, gpointer data)
379 switch (current_page)
389 GtkAssistant *assistant;
392 assistant = (GtkAssistant*) data;
393 page = gtk_assistant_get_nth_page (assistant, current_page);
395 if (gtk_toggle_button_get_active (GTK_TOGGLE_BUTTON (page)))
407 create_looping_assistant (GtkWidget *widget)
409 static GtkWidget *assistant = NULL;
415 assistant = gtk_assistant_new ();
416 gtk_window_set_default_size (GTK_WINDOW (assistant), 400, 300);
418 g_signal_connect (G_OBJECT (assistant), "cancel",
419 G_CALLBACK (cancel_callback), NULL);
420 g_signal_connect (G_OBJECT (assistant), "close",
421 G_CALLBACK (close_callback), NULL);
422 g_signal_connect (G_OBJECT (assistant), "apply",
423 G_CALLBACK (apply_callback), NULL);
424 g_signal_connect (G_OBJECT (assistant), "prepare",
425 G_CALLBACK (prepare_callback), NULL);
427 gtk_assistant_set_forward_page_func (GTK_ASSISTANT (assistant),
428 looping_assistant_forward_page,
431 page = get_test_page ("Introduction");
432 gtk_widget_show (page);
433 gtk_assistant_append_page (GTK_ASSISTANT (assistant), page);
434 gtk_assistant_set_page_title (GTK_ASSISTANT (assistant), page, "Introduction");
435 gtk_assistant_set_page_type (GTK_ASSISTANT (assistant), page, GTK_ASSISTANT_PAGE_INTRO);
436 gtk_assistant_set_page_complete (GTK_ASSISTANT (assistant), page, TRUE);
438 page = get_test_page ("Content");
439 gtk_widget_show (page);
440 gtk_assistant_append_page (GTK_ASSISTANT (assistant), page);
441 gtk_assistant_set_page_title (GTK_ASSISTANT (assistant), page, "Content");
442 gtk_assistant_set_page_complete (GTK_ASSISTANT (assistant), page, TRUE);
444 page = get_test_page ("More content");
445 gtk_widget_show (page);
446 gtk_assistant_append_page (GTK_ASSISTANT (assistant), page);
447 gtk_assistant_set_page_title (GTK_ASSISTANT (assistant), page, "More content");
448 gtk_assistant_set_page_complete (GTK_ASSISTANT (assistant), page, TRUE);
450 page = gtk_check_button_new_with_label ("Loop?");
451 gtk_widget_show (page);
452 gtk_assistant_append_page (GTK_ASSISTANT (assistant), page);
453 gtk_assistant_set_page_title (GTK_ASSISTANT (assistant), page, "Loop?");
454 gtk_assistant_set_page_complete (GTK_ASSISTANT (assistant), page, TRUE);
456 page = get_test_page ("Confirmation");
457 gtk_widget_show (page);
458 gtk_assistant_append_page (GTK_ASSISTANT (assistant), page);
459 gtk_assistant_set_page_title (GTK_ASSISTANT (assistant), page, "Confirmation");
460 gtk_assistant_set_page_type (GTK_ASSISTANT (assistant), page, GTK_ASSISTANT_PAGE_CONFIRM);
461 gtk_assistant_set_page_complete (GTK_ASSISTANT (assistant), page, TRUE);
464 if (!GTK_WIDGET_VISIBLE (assistant))
465 gtk_widget_show (assistant);
468 gtk_widget_destroy (assistant);
474 create_full_featured_assistant (GtkWidget *widget)
476 static GtkWidget *assistant = NULL;
480 GtkWidget *page, *button;
483 assistant = gtk_assistant_new ();
484 gtk_window_set_default_size (GTK_WINDOW (assistant), 400, 300);
486 button = gtk_button_new_from_stock (GTK_STOCK_STOP);
487 gtk_widget_show (button);
488 gtk_assistant_add_action_widget (GTK_ASSISTANT (assistant), button);
490 g_signal_connect (G_OBJECT (assistant), "cancel",
491 G_CALLBACK (cancel_callback), NULL);
492 g_signal_connect (G_OBJECT (assistant), "close",
493 G_CALLBACK (close_callback), NULL);
494 g_signal_connect (G_OBJECT (assistant), "apply",
495 G_CALLBACK (apply_callback), NULL);
496 g_signal_connect (G_OBJECT (assistant), "prepare",
497 G_CALLBACK (prepare_callback), NULL);
499 page = get_test_page ("Page 1");
500 gtk_widget_show (page);
501 gtk_assistant_append_page (GTK_ASSISTANT (assistant), page);
502 gtk_assistant_set_page_title (GTK_ASSISTANT (assistant), page, "Page 1");
503 gtk_assistant_set_page_complete (GTK_ASSISTANT (assistant), page, TRUE);
505 /* set a side image */
506 pixbuf = gtk_widget_render_icon (page, GTK_STOCK_DIALOG_WARNING, GTK_ICON_SIZE_DIALOG, NULL);
507 gtk_assistant_set_page_side_image (GTK_ASSISTANT (assistant), page, pixbuf);
509 /* set a header image */
510 pixbuf = gtk_widget_render_icon (page, GTK_STOCK_DIALOG_INFO, GTK_ICON_SIZE_DIALOG, NULL);
511 gtk_assistant_set_page_header_image (GTK_ASSISTANT (assistant), page, pixbuf);
513 page = get_test_page ("Invisible page");
514 gtk_assistant_append_page (GTK_ASSISTANT (assistant), page);
516 page = get_test_page ("Page 3");
517 gtk_widget_show (page);
518 gtk_assistant_append_page (GTK_ASSISTANT (assistant), page);
519 gtk_assistant_set_page_title (GTK_ASSISTANT (assistant), page, "Page 3");
520 gtk_assistant_set_page_type (GTK_ASSISTANT (assistant), page, GTK_ASSISTANT_PAGE_CONFIRM);
521 gtk_assistant_set_page_complete (GTK_ASSISTANT (assistant), page, TRUE);
523 /* set a header image */
524 pixbuf = gtk_widget_render_icon (page, GTK_STOCK_DIALOG_INFO, GTK_ICON_SIZE_DIALOG, NULL);
525 gtk_assistant_set_page_header_image (GTK_ASSISTANT (assistant), page, pixbuf);
528 if (!GTK_WIDGET_VISIBLE (assistant))
529 gtk_widget_show (assistant);
532 gtk_widget_destroy (assistant);
539 void (*func) (GtkWidget *widget);
542 { "simple assistant", create_simple_assistant },
543 { "generous assistant", create_generous_assistant },
544 { "nonlinear assistant", create_nonlinear_assistant },
545 { "looping assistant", create_looping_assistant },
546 { "full featured assistant", create_full_featured_assistant },
550 main (int argc, gchar *argv[])
552 GtkWidget *window, *box, *button;
555 gtk_init (&argc, &argv);
557 if (g_getenv ("RTL"))
558 gtk_widget_set_default_direction (GTK_TEXT_DIR_RTL);
560 window = gtk_window_new (GTK_WINDOW_TOPLEVEL);
562 g_signal_connect (G_OBJECT (window), "destroy",
563 G_CALLBACK (gtk_main_quit), NULL);
564 g_signal_connect (G_OBJECT (window), "delete-event",
565 G_CALLBACK (gtk_false), NULL);
567 box = gtk_vbox_new (FALSE, 6);
568 gtk_container_add (GTK_CONTAINER (window), box);
570 for (i = 0; i < G_N_ELEMENTS (buttons); i++)
572 button = gtk_button_new_with_label (buttons[i].text);
575 g_signal_connect (G_OBJECT (button), "clicked",
576 G_CALLBACK (buttons[i].func), NULL);
578 gtk_box_pack_start (GTK_BOX (box), button, TRUE, TRUE, 0);
581 gtk_widget_show_all (window);