mirror of
https://gitlab.gnome.org/GNOME/gtk.git
synced 2024-11-10 02:40:11 +00:00
212 lines
6.9 KiB
C
212 lines
6.9 KiB
C
/* Assistant
|
|
*
|
|
* Demonstrates a sample multi-step assistant with GtkAssistant. Assistants
|
|
* are used to divide an operation into several simpler sequential steps,
|
|
* and to guide the user through these steps.
|
|
*/
|
|
|
|
#include <gtk/gtk.h>
|
|
|
|
G_GNUC_BEGIN_IGNORE_DEPRECATIONS
|
|
|
|
static GtkWidget *progress_bar = NULL;
|
|
|
|
static gboolean
|
|
apply_changes_gradually (gpointer data)
|
|
{
|
|
double fraction;
|
|
|
|
/* Work, work, work... */
|
|
fraction = gtk_progress_bar_get_fraction (GTK_PROGRESS_BAR (progress_bar));
|
|
fraction += 0.05;
|
|
|
|
if (fraction < 1.0)
|
|
{
|
|
gtk_progress_bar_set_fraction (GTK_PROGRESS_BAR (progress_bar), fraction);
|
|
return G_SOURCE_CONTINUE;
|
|
}
|
|
else
|
|
{
|
|
/* Close automatically once changes are fully applied. */
|
|
gtk_window_destroy (GTK_WINDOW (data));
|
|
return G_SOURCE_REMOVE;
|
|
}
|
|
}
|
|
|
|
static void
|
|
on_assistant_apply (GtkWidget *widget, gpointer data)
|
|
{
|
|
/* Start a timer to simulate changes taking a few seconds to apply. */
|
|
g_timeout_add (100, apply_changes_gradually, widget);
|
|
}
|
|
|
|
static void
|
|
on_assistant_close_cancel (GtkWidget *widget, gpointer data)
|
|
{
|
|
gtk_window_destroy (GTK_WINDOW (widget));
|
|
}
|
|
|
|
static void
|
|
on_assistant_prepare (GtkWidget *widget, GtkWidget *page, gpointer data)
|
|
{
|
|
int current_page, n_pages;
|
|
char *title;
|
|
|
|
current_page = gtk_assistant_get_current_page (GTK_ASSISTANT (widget));
|
|
n_pages = gtk_assistant_get_n_pages (GTK_ASSISTANT (widget));
|
|
|
|
title = g_strdup_printf ("Sample assistant (%d of %d)", current_page + 1, n_pages);
|
|
gtk_window_set_title (GTK_WINDOW (widget), title);
|
|
g_free (title);
|
|
|
|
/* The fourth page (counting from zero) is the progress page. The
|
|
* user clicked Apply to get here so we tell the assistant to commit,
|
|
* which means the changes up to this point are permanent and cannot
|
|
* be cancelled or revisited. */
|
|
if (current_page == 3)
|
|
gtk_assistant_commit (GTK_ASSISTANT (widget));
|
|
}
|
|
|
|
static void
|
|
on_entry_changed (GtkWidget *widget, gpointer data)
|
|
{
|
|
GtkAssistant *assistant = GTK_ASSISTANT (data);
|
|
GtkWidget *current_page;
|
|
int page_number;
|
|
const char *text;
|
|
|
|
page_number = gtk_assistant_get_current_page (assistant);
|
|
current_page = gtk_assistant_get_nth_page (assistant, page_number);
|
|
text = gtk_editable_get_text (GTK_EDITABLE (widget));
|
|
|
|
if (text && *text)
|
|
gtk_assistant_set_page_complete (assistant, current_page, TRUE);
|
|
else
|
|
gtk_assistant_set_page_complete (assistant, current_page, FALSE);
|
|
}
|
|
|
|
static void
|
|
create_page1 (GtkWidget *assistant)
|
|
{
|
|
GtkWidget *box, *label, *entry;
|
|
|
|
box = gtk_box_new (GTK_ORIENTATION_HORIZONTAL, 12);
|
|
gtk_widget_set_margin_start (box, 12);
|
|
gtk_widget_set_margin_end (box, 12);
|
|
gtk_widget_set_margin_top (box, 12);
|
|
gtk_widget_set_margin_bottom (box, 12);
|
|
|
|
label = gtk_label_new ("You must fill out this entry to continue:");
|
|
gtk_box_append (GTK_BOX (box), label);
|
|
|
|
entry = gtk_entry_new ();
|
|
gtk_accessible_update_relation (GTK_ACCESSIBLE (entry),
|
|
GTK_ACCESSIBLE_RELATION_LABELLED_BY, label, NULL,
|
|
-1);
|
|
gtk_entry_set_activates_default (GTK_ENTRY (entry), TRUE);
|
|
gtk_widget_set_valign (entry, GTK_ALIGN_CENTER);
|
|
gtk_box_append (GTK_BOX (box), entry);
|
|
g_signal_connect (G_OBJECT (entry), "changed",
|
|
G_CALLBACK (on_entry_changed), assistant);
|
|
|
|
gtk_assistant_append_page (GTK_ASSISTANT (assistant), box);
|
|
gtk_assistant_set_page_title (GTK_ASSISTANT (assistant), box, "Page 1");
|
|
gtk_assistant_set_page_type (GTK_ASSISTANT (assistant), box, GTK_ASSISTANT_PAGE_INTRO);
|
|
}
|
|
|
|
static void
|
|
create_page2 (GtkWidget *assistant)
|
|
{
|
|
GtkWidget *box, *checkbutton;
|
|
|
|
box = gtk_box_new (GTK_ORIENTATION_HORIZONTAL, 12);
|
|
gtk_widget_set_margin_start (box, 12);
|
|
gtk_widget_set_margin_end (box, 12);
|
|
gtk_widget_set_margin_top (box, 12);
|
|
gtk_widget_set_margin_bottom (box, 12);
|
|
|
|
checkbutton = gtk_check_button_new_with_label ("This is optional data, you may continue "
|
|
"even if you do not check this");
|
|
gtk_widget_set_valign (checkbutton, GTK_ALIGN_CENTER);
|
|
gtk_box_append (GTK_BOX (box), checkbutton);
|
|
|
|
gtk_assistant_append_page (GTK_ASSISTANT (assistant), box);
|
|
gtk_assistant_set_page_complete (GTK_ASSISTANT (assistant), box, TRUE);
|
|
gtk_assistant_set_page_title (GTK_ASSISTANT (assistant), box, "Page 2");
|
|
}
|
|
|
|
static void
|
|
create_page3 (GtkWidget *assistant)
|
|
{
|
|
GtkWidget *label;
|
|
|
|
label = gtk_label_new ("This is a confirmation page, press 'Apply' to apply changes");
|
|
|
|
gtk_assistant_append_page (GTK_ASSISTANT (assistant), label);
|
|
gtk_assistant_set_page_type (GTK_ASSISTANT (assistant), label, GTK_ASSISTANT_PAGE_CONFIRM);
|
|
gtk_assistant_set_page_complete (GTK_ASSISTANT (assistant), label, TRUE);
|
|
gtk_assistant_set_page_title (GTK_ASSISTANT (assistant), label, "Confirmation");
|
|
}
|
|
|
|
static void
|
|
create_page4 (GtkWidget *assistant)
|
|
{
|
|
progress_bar = gtk_progress_bar_new ();
|
|
gtk_widget_set_halign (progress_bar, GTK_ALIGN_FILL);
|
|
gtk_widget_set_valign (progress_bar, GTK_ALIGN_CENTER);
|
|
gtk_widget_set_hexpand (progress_bar, TRUE);
|
|
gtk_widget_set_margin_start (progress_bar, 40);
|
|
gtk_widget_set_margin_end (progress_bar, 40);
|
|
|
|
gtk_assistant_append_page (GTK_ASSISTANT (assistant), progress_bar);
|
|
gtk_assistant_set_page_type (GTK_ASSISTANT (assistant), progress_bar, GTK_ASSISTANT_PAGE_PROGRESS);
|
|
gtk_assistant_set_page_title (GTK_ASSISTANT (assistant), progress_bar, "Applying changes");
|
|
|
|
gtk_accessible_update_property (GTK_ACCESSIBLE (progress_bar),
|
|
GTK_ACCESSIBLE_PROPERTY_LABEL, "Applying changes",
|
|
-1);
|
|
|
|
/* This prevents the assistant window from being
|
|
* closed while we're "busy" applying changes.
|
|
*/
|
|
gtk_assistant_set_page_complete (GTK_ASSISTANT (assistant), progress_bar, FALSE);
|
|
}
|
|
|
|
GtkWidget*
|
|
do_assistant (GtkWidget *do_widget)
|
|
{
|
|
static GtkWidget *assistant;
|
|
|
|
if (!assistant)
|
|
{
|
|
assistant = gtk_assistant_new ();
|
|
|
|
gtk_window_set_default_size (GTK_WINDOW (assistant), -1, 300);
|
|
|
|
gtk_window_set_display (GTK_WINDOW (assistant),
|
|
gtk_widget_get_display (do_widget));
|
|
g_object_add_weak_pointer (G_OBJECT (assistant), (gpointer *)&assistant);
|
|
|
|
create_page1 (assistant);
|
|
create_page2 (assistant);
|
|
create_page3 (assistant);
|
|
create_page4 (assistant);
|
|
|
|
g_signal_connect (G_OBJECT (assistant), "cancel",
|
|
G_CALLBACK (on_assistant_close_cancel), NULL);
|
|
g_signal_connect (G_OBJECT (assistant), "close",
|
|
G_CALLBACK (on_assistant_close_cancel), NULL);
|
|
g_signal_connect (G_OBJECT (assistant), "apply",
|
|
G_CALLBACK (on_assistant_apply), NULL);
|
|
g_signal_connect (G_OBJECT (assistant), "prepare",
|
|
G_CALLBACK (on_assistant_prepare), NULL);
|
|
}
|
|
|
|
if (!gtk_widget_get_visible (assistant))
|
|
gtk_widget_set_visible (assistant, TRUE);
|
|
else
|
|
gtk_window_destroy (GTK_WINDOW (assistant));
|
|
|
|
return assistant;
|
|
}
|