diff options
| author | Matthias Clasen <mclasen@redhat.com> | 2006-01-18 22:39:14 +0000 |
|---|---|---|
| committer | Matthias Clasen <matthiasc@src.gnome.org> | 2006-01-18 22:39:14 +0000 |
| commit | c73b9a7759c7fc026062d9e8132a4943bfdafd7d (patch) | |
| tree | 6d7dd3e56e75e5753a1bf38ecfc882027d60d273 /gtk/gtkassistant.h | |
| parent | 4b705d23d23338bef24f0897bdbfec0ef5507c9f (diff) | |
| download | gtk+-c73b9a7759c7fc026062d9e8132a4943bfdafd7d.tar.gz | |
Add GtkAssistant, a widget to construct multi-step wizards. (#115348,
2006-01-18 Matthias Clasen <mclasen@redhat.com>
* gtk/gtkassistant.[hc]: Add GtkAssistant, a widget to
construct multi-step wizards. (#115348, Martyn Russell,
Matthias Clasen, Carlos Garnacho Parro)
* gtk/gtk.symbols:
* gtk/Makefile.am:
* gtk/gtk.h: Necessary glue.
Diffstat (limited to 'gtk/gtkassistant.h')
| -rw-r--r-- | gtk/gtkassistant.h | 135 |
1 files changed, 135 insertions, 0 deletions
diff --git a/gtk/gtkassistant.h b/gtk/gtkassistant.h new file mode 100644 index 0000000000..5d294774f6 --- /dev/null +++ b/gtk/gtkassistant.h @@ -0,0 +1,135 @@ +/*
+ * GTK - The GIMP Toolkit
+ * Copyright (C) 1999 Red Hat, Inc.
+ * Copyright (C) 2002 Anders Carlsson <andersca@gnu.org>
+ * Copyright (C) 2003 Matthias Clasen <mclasen@redhat.com>
+ * Copyright (C) 2005 Carlos Garnacho Parro <carlosg@gnome.org>
+ *
+ * All rights reserved.
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the
+ * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
+ * Boston, MA 02111-1307, USA.
+ */
+
+#ifndef __GTK_ASSISTANT_H__
+#define __GTK_ASSISTANT_H__
+
+#include <gtk/gtkwidget.h>
+#include <gtk/gtkwindow.h>
+
+G_BEGIN_DECLS
+
+#define GTK_TYPE_ASSISTANT (gtk_assistant_get_type ())
+#define GTK_ASSISTANT(o) (G_TYPE_CHECK_INSTANCE_CAST ((o), GTK_TYPE_ASSISTANT, GtkAssistant))
+#define GTK_ASSISTANT_CLASS(c) (G_TYPE_CHECK_CLASS_CAST ((c), GTK_TYPE_ASSISTANT, GtkAssistantClass))
+#define GTK_IS_ASSISTANT(o) (G_TYPE_CHECK_INSTANCE_TYPE ((o), GTK_TYPE_ASSISTANT))
+#define GTK_IS_ASSISTANT_CLASS(c) (G_TYPE_CHECK_CLASS_TYPE ((c), GTK_TYPE_ASSISTANT))
+#define GTK_ASSISTANT_GET_CLASS(o) (G_TYPE_INSTANCE_GET_CLASS ((o), GTK_TYPE_ASSISTANT, GtkAssistantClass))
+
+typedef enum
+{
+ GTK_ASSISTANT_PAGE_CONTENT,
+ GTK_ASSISTANT_PAGE_INTRO,
+ GTK_ASSISTANT_PAGE_CONFIRM,
+ GTK_ASSISTANT_PAGE_SUMMARY,
+ GTK_ASSISTANT_PAGE_PROGRESS
+} GtkAssistantPageType;
+
+typedef struct _GtkAssistant GtkAssistant;
+typedef struct _GtkAssistantClass GtkAssistantClass;
+
+struct _GtkAssistant
+{
+ GtkWindow parent;
+
+ GtkWidget *cancel;
+ GtkWidget *forward;
+ GtkWidget *back;
+ GtkWidget *apply;
+ GtkWidget *close;
+ GtkWidget *last;
+};
+
+struct _GtkAssistantClass
+{
+ GtkWindowClass parent_class;
+
+ void (* prepare) (GtkAssistant *assistant);
+ void (* apply) (GtkAssistant *assistant);
+ void (* close) (GtkAssistant *assistant);
+ void (* cancel) (GtkAssistant *assistant);
+
+ /* Padding for future expansion */
+ void (*_gtk_reserved1) (void);
+ void (*_gtk_reserved2) (void);
+ void (*_gtk_reserved3) (void);
+ void (*_gtk_reserved4) (void);
+ void (*_gtk_reserved5) (void);
+};
+
+typedef gint (*GtkAssistantPageFunc) (gint current_page, gpointer data);
+
+GType gtk_assistant_get_type (void) G_GNUC_CONST;
+GtkWidget *gtk_assistant_new (void);
+gint gtk_assistant_get_current_page (GtkAssistant *assistant);
+void gtk_assistant_set_current_page (GtkAssistant *assistant,
+ gint page_num);
+gint gtk_assistant_get_n_pages (GtkAssistant *assistant);
+GtkWidget *gtk_assistant_get_nth_page (GtkAssistant *assistant,
+ gint page_num);
+gint gtk_assistant_prepend_page (GtkAssistant *assistant,
+ GtkWidget *page);
+gint gtk_assistant_append_page (GtkAssistant *assistant,
+ GtkWidget *page);
+gint gtk_assistant_insert_page (GtkAssistant *assistant,
+ GtkWidget *page,
+ gint position);
+void gtk_assistant_set_forward_page_func (GtkAssistant *assistant,
+ GtkAssistantPageFunc page_func,
+ gpointer data,
+ GDestroyNotify destroy);
+void gtk_assistant_set_page_type (GtkAssistant *assistant,
+ GtkWidget *page,
+ GtkAssistantPageType type);
+GtkAssistantPageType gtk_assistant_get_page_type (GtkAssistant *assistant,
+ GtkWidget *page);
+void gtk_assistant_set_page_title (GtkAssistant *assistant,
+ GtkWidget *page,
+ const gchar *title);
+G_CONST_RETURN gchar *gtk_assistant_get_page_title (GtkAssistant *assistant,
+ GtkWidget *page);
+void gtk_assistant_set_page_header_image (GtkAssistant *assistant,
+ GtkWidget *page,
+ GdkPixbuf *pixbuf);
+GdkPixbuf *gtk_assistant_get_page_header_image (GtkAssistant *assistant,
+ GtkWidget *page);
+void gtk_assistant_set_page_side_image (GtkAssistant *assistant,
+ GtkWidget *page,
+ GdkPixbuf *pixbuf);
+GdkPixbuf *gtk_assistant_get_page_side_image (GtkAssistant *assistant,
+ GtkWidget *page);
+void gtk_assistant_set_page_complete (GtkAssistant *assistant,
+ GtkWidget *page,
+ gboolean complete);
+gboolean gtk_assistant_get_page_complete (GtkAssistant *assistant,
+ GtkWidget *page);
+void gtk_assistant_add_action_widget (GtkAssistant *assistant,
+ GtkWidget *child);
+void gtk_assistant_remove_action_widget (GtkAssistant *assistant,
+ GtkWidget *child);
+
+G_END_DECLS
+
+#endif /* __GTK_ASSISTANT_H__ */
|