AuroraMiddleware/gtk2
1
0
Fork 0
forked from AuroraMiddleware/gtk
Code Issues Pull Requests Projects Releases Wiki Activity
4549172825
gtk2/gtk/gtkstack.h

187 lines
8.9 KiB
C
Raw Normal View History

Add GtkStack Add separate GtkStack and GtkStackSwitcher widgets that are an alternative to GtkNotebook. Additionally, GtkStack supports animated transitions when changing pages. These widgets were initially developed in libgd.
2013-04-21 11:51:14 +00:00
/*
* Copyright (c) 2013 Red Hat, Inc.
*
* This program 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 program 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 program; if not, write to the Free Software Foundation,
* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
*
* Author: Alexander Larsson <alexl@redhat.com>
*
*/
#ifndef __GTK_STACK_H__
#define __GTK_STACK_H__
Add a few missing include guards
2014-10-01 04:49:59 +00:00
#if !defined (__GTK_H_INSIDE__) && !defined (GTK_COMPILATION)
#error "Only <gtk/gtk.h> can be included directly."
#endif
stack: Derive from GtkWidget
2020-05-07 20:04:42 +00:00
#include <gtk/gtkwidget.h>
stack: Provide a selection model Make GtkStack expose a selection model for its pages. The model can be used to track changes to the pages, and to change what child is visible.
2019-02-10 23:22:54 +00:00
#include <gtk/gtkselectionmodel.h>
Add GtkStack Add separate GtkStack and GtkStackSwitcher widgets that are an alternative to GtkNotebook. Additionally, GtkStack supports animated transitions when changing pages. These widgets were initially developed in libgd.
2013-04-21 11:51:14 +00:00
G_BEGIN_DECLS
#define GTK_TYPE_STACK (gtk_stack_get_type ())
#define GTK_STACK(obj) (G_TYPE_CHECK_INSTANCE_CAST ((obj), GTK_TYPE_STACK, GtkStack))
#define GTK_IS_STACK(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GTK_TYPE_STACK))
typedef struct _GtkStack GtkStack;
stack: Convert child properties to a child meta object Create a GtkStackPage public object which holds the former child properties of GtkStack. Adjust all callers.
2019-02-06 17:54:18 +00:00
#define GTK_TYPE_STACK_PAGE (gtk_stack_page_get_type ())
#define GTK_STACK_PAGE(obj) (G_TYPE_CHECK_INSTANCE_CAST ((obj), GTK_TYPE_STACK_PAGE, GtkStackPage))
#define GTK_IS_STACK_PAGE(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GTK_TYPE_STACK_PAGE))
typedef struct _GtkStackPage GtkStackPage;
Add GtkStack Add separate GtkStack and GtkStackSwitcher widgets that are an alternative to GtkNotebook. Additionally, GtkStack supports animated transitions when changing pages. These widgets were initially developed in libgd.
2013-04-21 11:51:14 +00:00
typedef enum {
GTK_STACK_TRANSITION_TYPE_NONE,
GTK_STACK_TRANSITION_TYPE_CROSSFADE,
GTK_STACK_TRANSITION_TYPE_SLIDE_RIGHT,
GtkStack: add vertical slide transitions We allow transitions that slide up or down.
2013-04-22 00:17:40 +00:00
GTK_STACK_TRANSITION_TYPE_SLIDE_LEFT,
GTK_STACK_TRANSITION_TYPE_SLIDE_UP,
GtkStack: Add position-dependent slide transitions These go left/right or up/down depending on the relative order of the children being switched between.
2013-06-13 18:33:42 +00:00
GTK_STACK_TRANSITION_TYPE_SLIDE_DOWN,
GTK_STACK_TRANSITION_TYPE_SLIDE_LEFT_RIGHT,
GtkStack: Add more transition types This adds new 'over' and 'under' transitions which work by moving the new page over the previous one, or moving the previous page off to reveal the new one. We also add an over/under combination that is going to be used in GtkAboutDialog. https://bugzilla.gnome.org/show_bug.cgi?id=707187
2013-08-31 16:00:47 +00:00
GTK_STACK_TRANSITION_TYPE_SLIDE_UP_DOWN,
GTK_STACK_TRANSITION_TYPE_OVER_UP,
GTK_STACK_TRANSITION_TYPE_OVER_DOWN,
GTK_STACK_TRANSITION_TYPE_OVER_LEFT,
GTK_STACK_TRANSITION_TYPE_OVER_RIGHT,
GTK_STACK_TRANSITION_TYPE_UNDER_UP,
GTK_STACK_TRANSITION_TYPE_UNDER_DOWN,
GTK_STACK_TRANSITION_TYPE_UNDER_LEFT,
GTK_STACK_TRANSITION_TYPE_UNDER_RIGHT,
stack: Add counterparts of OVER_UP_DOWN transition The GtkStackTransitionType enum now has OVER_DOWN_UP, OVER_LEFT_RIGHT, and OVER_RIGHT_LEFT values to complement OVER_UP_DOWN. https://bugzilla.gnome.org/show_bug.cgi?id=726676
2014-03-19 03:42:59 +00:00
GTK_STACK_TRANSITION_TYPE_OVER_UP_DOWN,
GTK_STACK_TRANSITION_TYPE_OVER_DOWN_UP,
GTK_STACK_TRANSITION_TYPE_OVER_LEFT_RIGHT,
stack: Add a cube spin transition Add a transition to GtkStack that pretends pages are the sides or a cube, and switch them by rotating the cube. Use this transition in widget-factory.
2019-03-05 19:44:45 +00:00
GTK_STACK_TRANSITION_TYPE_OVER_RIGHT_LEFT,
GTK_STACK_TRANSITION_TYPE_ROTATE_LEFT,
GTK_STACK_TRANSITION_TYPE_ROTATE_RIGHT,
GTK_STACK_TRANSITION_TYPE_ROTATE_LEFT_RIGHT
Add GtkStack Add separate GtkStack and GtkStackSwitcher widgets that are an alternative to GtkNotebook. Additionally, GtkStack supports animated transitions when changing pages. These widgets were initially developed in libgd.
2013-04-21 11:51:14 +00:00
} GtkStackTransitionType;
stack: Convert child properties to a child meta object Create a GtkStackPage public object which holds the former child properties of GtkStack. Adjust all callers.
2019-02-06 17:54:18 +00:00
GDK_AVAILABLE_IN_ALL
stack: Add missing accessors for GtkStackPage properties
2020-06-18 05:55:22 +00:00
GType gtk_stack_page_get_type (void) G_GNUC_CONST;
stack: Add GtkStackPage:visible accessors
2020-02-18 08:27:42 +00:00
GDK_AVAILABLE_IN_ALL
stack: Cosmetic documentation fixes Fix parameter mismatches.
2020-06-28 12:06:17 +00:00
GtkWidget * gtk_stack_page_get_child (GtkStackPage *self);
stack: Add GtkStackPage:visible accessors
2020-02-18 08:27:42 +00:00
GDK_AVAILABLE_IN_ALL
stack: Add missing accessors for GtkStackPage properties
2020-06-18 05:55:22 +00:00
gboolean gtk_stack_page_get_visible (GtkStackPage *self);
stack: Add GtkStackPage:visible accessors
2020-02-18 08:27:42 +00:00
GDK_AVAILABLE_IN_ALL
stack: Add missing accessors for GtkStackPage properties
2020-06-18 05:55:22 +00:00
void gtk_stack_page_set_visible (GtkStackPage *self,
gboolean visible);
GDK_AVAILABLE_IN_ALL
gboolean gtk_stack_page_get_needs_attention (GtkStackPage *self);
GDK_AVAILABLE_IN_ALL
void gtk_stack_page_set_needs_attention (GtkStackPage *self,
gboolean setting);
GDK_AVAILABLE_IN_ALL
gboolean gtk_stack_page_get_use_underline (GtkStackPage *self);
GDK_AVAILABLE_IN_ALL
void gtk_stack_page_set_use_underline (GtkStackPage *self,
gboolean setting);
GDK_AVAILABLE_IN_ALL
const char * gtk_stack_page_get_name (GtkStackPage *self);
GDK_AVAILABLE_IN_ALL
void gtk_stack_page_set_name (GtkStackPage *self,
const char *setting);
GDK_AVAILABLE_IN_ALL
const char * gtk_stack_page_get_title (GtkStackPage *self);
GDK_AVAILABLE_IN_ALL
void gtk_stack_page_set_title (GtkStackPage *self,
const char *setting);
GDK_AVAILABLE_IN_ALL
const char * gtk_stack_page_get_icon_name (GtkStackPage *self);
GDK_AVAILABLE_IN_ALL
void gtk_stack_page_set_icon_name (GtkStackPage *self,
const char *setting);
stack: Convert child properties to a child meta object Create a GtkStackPage public object which holds the former child properties of GtkStack. Adjust all callers.
2019-02-06 17:54:18 +00:00
The big versioning cleanup Remove all the old 2.x and 3.x version annotations. GTK+ 4 is a new start, and from the perspective of a GTK+ 4 developer all these APIs have been around since the beginning.
2018-02-05 19:13:20 +00:00
GDK_AVAILABLE_IN_ALL
Add GtkStack Add separate GtkStack and GtkStackSwitcher widgets that are an alternative to GtkNotebook. Additionally, GtkStack supports animated transitions when changing pages. These widgets were initially developed in libgd.
2013-04-21 11:51:14 +00:00
GType gtk_stack_get_type (void) G_GNUC_CONST;
The big versioning cleanup Remove all the old 2.x and 3.x version annotations. GTK+ 4 is a new start, and from the perspective of a GTK+ 4 developer all these APIs have been around since the beginning.
2018-02-05 19:13:20 +00:00
GDK_AVAILABLE_IN_ALL
Add GtkStack Add separate GtkStack and GtkStackSwitcher widgets that are an alternative to GtkNotebook. Additionally, GtkStack supports animated transitions when changing pages. These widgets were initially developed in libgd.
2013-04-21 11:51:14 +00:00
GtkWidget * gtk_stack_new (void);
The big versioning cleanup Remove all the old 2.x and 3.x version annotations. GTK+ 4 is a new start, and from the perspective of a GTK+ 4 developer all these APIs have been around since the beginning.
2018-02-05 19:13:20 +00:00
GDK_AVAILABLE_IN_ALL
stack: Add gtk_stack_add_child The name of children is not essential, so add a way to add children without providing one. Fixes: #3165
2020-09-15 22:37:56 +00:00
GtkStackPage * gtk_stack_add_child (GtkStack *stack,
GtkWidget *child);
GDK_AVAILABLE_IN_ALL
stack: return the stack page when adding a child, to ease setting props
2019-11-04 02:05:03 +00:00
GtkStackPage * gtk_stack_add_named (GtkStack *stack,
Add GtkStack Add separate GtkStack and GtkStackSwitcher widgets that are an alternative to GtkNotebook. Additionally, GtkStack supports animated transitions when changing pages. These widgets were initially developed in libgd.
2013-04-21 11:51:14 +00:00
GtkWidget *child,
Replace "gchar" with "char"
2020-07-24 18:40:36 +00:00
const char *name);
The big versioning cleanup Remove all the old 2.x and 3.x version annotations. GTK+ 4 is a new start, and from the perspective of a GTK+ 4 developer all these APIs have been around since the beginning.
2018-02-05 19:13:20 +00:00
GDK_AVAILABLE_IN_ALL
stack: return the stack page when adding a child, to ease setting props
2019-11-04 02:05:03 +00:00
GtkStackPage * gtk_stack_add_titled (GtkStack *stack,
Add GtkStack Add separate GtkStack and GtkStackSwitcher widgets that are an alternative to GtkNotebook. Additionally, GtkStack supports animated transitions when changing pages. These widgets were initially developed in libgd.
2013-04-21 11:51:14 +00:00
GtkWidget *child,
Replace "gchar" with "char"
2020-07-24 18:40:36 +00:00
const char *name,
const char *title);
stack: Add gtk_stack_remove This is a replacement for gtk_container_remove.
2020-05-07 19:49:04 +00:00
GDK_AVAILABLE_IN_ALL
void gtk_stack_remove (GtkStack *stack,
GtkWidget *child);
stack: Convert child properties to a child meta object Create a GtkStackPage public object which holds the former child properties of GtkStack. Adjust all callers.
2019-02-06 17:54:18 +00:00
GDK_AVAILABLE_IN_ALL
GtkStackPage * gtk_stack_get_page (GtkStack *stack,
GtkWidget *child);
The big versioning cleanup Remove all the old 2.x and 3.x version annotations. GTK+ 4 is a new start, and from the perspective of a GTK+ 4 developer all these APIs have been around since the beginning.
2018-02-05 19:13:20 +00:00
GDK_AVAILABLE_IN_ALL
GtkStack: add gtk_stack_get_child_by_name() This new method allows getting a widget from a GtkStack when we know its name, and will also return NULL if there is no widget going by that name. Usage example would be to check if a child with a given name exists before calling gtk_stack_set_visible_child_name(). https://bugzilla.gnome.org/show_bug.cgi?id=722588
2014-01-20 08:32:37 +00:00
GtkWidget * gtk_stack_get_child_by_name (GtkStack *stack,
Replace "gchar" with "char"
2020-07-24 18:40:36 +00:00
const char *name);
The big versioning cleanup Remove all the old 2.x and 3.x version annotations. GTK+ 4 is a new start, and from the perspective of a GTK+ 4 developer all these APIs have been around since the beginning.
2018-02-05 19:13:20 +00:00
GDK_AVAILABLE_IN_ALL
Add GtkStack Add separate GtkStack and GtkStackSwitcher widgets that are an alternative to GtkNotebook. Additionally, GtkStack supports animated transitions when changing pages. These widgets were initially developed in libgd.
2013-04-21 11:51:14 +00:00
void gtk_stack_set_visible_child (GtkStack *stack,
GtkWidget *child);
The big versioning cleanup Remove all the old 2.x and 3.x version annotations. GTK+ 4 is a new start, and from the perspective of a GTK+ 4 developer all these APIs have been around since the beginning.
2018-02-05 19:13:20 +00:00
GDK_AVAILABLE_IN_ALL
Add GtkStack Add separate GtkStack and GtkStackSwitcher widgets that are an alternative to GtkNotebook. Additionally, GtkStack supports animated transitions when changing pages. These widgets were initially developed in libgd.
2013-04-21 11:51:14 +00:00
GtkWidget * gtk_stack_get_visible_child (GtkStack *stack);
The big versioning cleanup Remove all the old 2.x and 3.x version annotations. GTK+ 4 is a new start, and from the perspective of a GTK+ 4 developer all these APIs have been around since the beginning.
2018-02-05 19:13:20 +00:00
GDK_AVAILABLE_IN_ALL
Add GtkStack Add separate GtkStack and GtkStackSwitcher widgets that are an alternative to GtkNotebook. Additionally, GtkStack supports animated transitions when changing pages. These widgets were initially developed in libgd.
2013-04-21 11:51:14 +00:00
void gtk_stack_set_visible_child_name (GtkStack *stack,
Replace "gchar" with "char"
2020-07-24 18:40:36 +00:00
const char *name);
The big versioning cleanup Remove all the old 2.x and 3.x version annotations. GTK+ 4 is a new start, and from the perspective of a GTK+ 4 developer all these APIs have been around since the beginning.
2018-02-05 19:13:20 +00:00
GDK_AVAILABLE_IN_ALL
Replace "gchar" with "char"
2020-07-24 18:40:36 +00:00
const char * gtk_stack_get_visible_child_name (GtkStack *stack);
The big versioning cleanup Remove all the old 2.x and 3.x version annotations. GTK+ 4 is a new start, and from the perspective of a GTK+ 4 developer all these APIs have been around since the beginning.
2018-02-05 19:13:20 +00:00
GDK_AVAILABLE_IN_ALL
Add a way to specify transition types on the fly Add a gtk_stack_set_visible_child_full that takes a transition type.
2013-04-21 18:22:35 +00:00
void gtk_stack_set_visible_child_full (GtkStack *stack,
Replace "gchar" with "char"
2020-07-24 18:40:36 +00:00
const char *name,
GtkStack: shorten a few parameter names Looks better in the docs.
2013-04-22 03:13:16 +00:00
GtkStackTransitionType transition);
The big versioning cleanup Remove all the old 2.x and 3.x version annotations. GTK+ 4 is a new start, and from the perspective of a GTK+ 4 developer all these APIs have been around since the beginning.
2018-02-05 19:13:20 +00:00
GDK_AVAILABLE_IN_ALL
GtkStack: split homogeneous Split homogeneous into separate hhomogeneous and vhomogeneous properties. vhomogeneous is what we want for popover menus.
2014-10-26 18:59:21 +00:00
void gtk_stack_set_hhomogeneous (GtkStack *stack,
gboolean hhomogeneous);
The big versioning cleanup Remove all the old 2.x and 3.x version annotations. GTK+ 4 is a new start, and from the perspective of a GTK+ 4 developer all these APIs have been around since the beginning.
2018-02-05 19:13:20 +00:00
GDK_AVAILABLE_IN_ALL
GtkStack: split homogeneous Split homogeneous into separate hhomogeneous and vhomogeneous properties. vhomogeneous is what we want for popover menus.
2014-10-26 18:59:21 +00:00
gboolean gtk_stack_get_hhomogeneous (GtkStack *stack);
The big versioning cleanup Remove all the old 2.x and 3.x version annotations. GTK+ 4 is a new start, and from the perspective of a GTK+ 4 developer all these APIs have been around since the beginning.
2018-02-05 19:13:20 +00:00
GDK_AVAILABLE_IN_ALL
GtkStack: split homogeneous Split homogeneous into separate hhomogeneous and vhomogeneous properties. vhomogeneous is what we want for popover menus.
2014-10-26 18:59:21 +00:00
void gtk_stack_set_vhomogeneous (GtkStack *stack,
gboolean vhomogeneous);
The big versioning cleanup Remove all the old 2.x and 3.x version annotations. GTK+ 4 is a new start, and from the perspective of a GTK+ 4 developer all these APIs have been around since the beginning.
2018-02-05 19:13:20 +00:00
GDK_AVAILABLE_IN_ALL
GtkStack: split homogeneous Split homogeneous into separate hhomogeneous and vhomogeneous properties. vhomogeneous is what we want for popover menus.
2014-10-26 18:59:21 +00:00
gboolean gtk_stack_get_vhomogeneous (GtkStack *stack);
The big versioning cleanup Remove all the old 2.x and 3.x version annotations. GTK+ 4 is a new start, and from the perspective of a GTK+ 4 developer all these APIs have been around since the beginning.
2018-02-05 19:13:20 +00:00
GDK_AVAILABLE_IN_ALL
Add GtkStack Add separate GtkStack and GtkStackSwitcher widgets that are an alternative to GtkNotebook. Additionally, GtkStack supports animated transitions when changing pages. These widgets were initially developed in libgd.
2013-04-21 11:51:14 +00:00
void gtk_stack_set_transition_duration (GtkStack *stack,
GtkStack: shorten a few parameter names Looks better in the docs.
2013-04-22 03:13:16 +00:00
guint duration);
The big versioning cleanup Remove all the old 2.x and 3.x version annotations. GTK+ 4 is a new start, and from the perspective of a GTK+ 4 developer all these APIs have been around since the beginning.
2018-02-05 19:13:20 +00:00
GDK_AVAILABLE_IN_ALL
Make transition-duration unsigned The code doesn't deal with negative durations, so better don't allow them.
2013-04-22 01:31:29 +00:00
guint gtk_stack_get_transition_duration (GtkStack *stack);
The big versioning cleanup Remove all the old 2.x and 3.x version annotations. GTK+ 4 is a new start, and from the perspective of a GTK+ 4 developer all these APIs have been around since the beginning.
2018-02-05 19:13:20 +00:00
GDK_AVAILABLE_IN_ALL
Add GtkStack Add separate GtkStack and GtkStackSwitcher widgets that are an alternative to GtkNotebook. Additionally, GtkStack supports animated transitions when changing pages. These widgets were initially developed in libgd.
2013-04-21 11:51:14 +00:00
void gtk_stack_set_transition_type (GtkStack *stack,
GtkStack: shorten a few parameter names Looks better in the docs.
2013-04-22 03:13:16 +00:00
GtkStackTransitionType transition);
The big versioning cleanup Remove all the old 2.x and 3.x version annotations. GTK+ 4 is a new start, and from the perspective of a GTK+ 4 developer all these APIs have been around since the beginning.
2018-02-05 19:13:20 +00:00
GDK_AVAILABLE_IN_ALL
Add GtkStack Add separate GtkStack and GtkStackSwitcher widgets that are an alternative to GtkNotebook. Additionally, GtkStack supports animated transitions when changing pages. These widgets were initially developed in libgd.
2013-04-21 11:51:14 +00:00
GtkStackTransitionType gtk_stack_get_transition_type (GtkStack *stack);
The big versioning cleanup Remove all the old 2.x and 3.x version annotations. GTK+ 4 is a new start, and from the perspective of a GTK+ 4 developer all these APIs have been around since the beginning.
2018-02-05 19:13:20 +00:00
GDK_AVAILABLE_IN_ALL
GtkStack: add transition-running property This is useful to know when the transition is done we can remove the child from the stack. https://bugzilla.gnome.org/show_bug.cgi?id=711494
2013-11-11 21:38:35 +00:00
gboolean gtk_stack_get_transition_running (GtkStack *stack);
The big versioning cleanup Remove all the old 2.x and 3.x version annotations. GTK+ 4 is a new start, and from the perspective of a GTK+ 4 developer all these APIs have been around since the beginning.
2018-02-05 19:13:20 +00:00
GDK_AVAILABLE_IN_ALL
GtkStack: Add interpolate-size property And use it to determine whether we should actually interpolate between stack sizes or not.
2015-07-19 15:39:41 +00:00
void gtk_stack_set_interpolate_size (GtkStack *stack,
gboolean interpolate_size);
The big versioning cleanup Remove all the old 2.x and 3.x version annotations. GTK+ 4 is a new start, and from the perspective of a GTK+ 4 developer all these APIs have been around since the beginning.
2018-02-05 19:13:20 +00:00
GDK_AVAILABLE_IN_ALL
GtkStack: Add interpolate-size property And use it to determine whether we should actually interpolate between stack sizes or not.
2015-07-19 15:39:41 +00:00
gboolean gtk_stack_get_interpolate_size (GtkStack *stack);
stack: Provide a selection model Make GtkStack expose a selection model for its pages. The model can be used to track changes to the pages, and to change what child is visible.
2019-02-10 23:22:54 +00:00
GDK_AVAILABLE_IN_ALL
GtkSelectionModel * gtk_stack_get_pages (GtkStack *stack);
gtk: Dissolve gtk-autocleanup.h Move the autocleanup declarations into their respective headers.
2022-09-24 01:54:15 +00:00
G_DEFINE_AUTOPTR_CLEANUP_FUNC(GtkStack, g_object_unref)
Add GtkStack Add separate GtkStack and GtkStackSwitcher widgets that are an alternative to GtkNotebook. Additionally, GtkStack supports animated transitions when changing pages. These widgets were initially developed in libgd.
2013-04-21 11:51:14 +00:00
G_END_DECLS
#endif
Reference in New Issue Copy Permalink