AuroraMiddleware/gtk2
1
0
Fork 0
forked from AuroraMiddleware/gtk
Code Issues Pull Requests Projects Releases Wiki Activity
35744d87a2
gtk2/gtk/gtkscrollable.h

81 lines
3.2 KiB
C
Raw Normal View History

Add GtkScrollable interface The GtkScrollable interface provides "hadjustment" and "vadjustment" properties that are used by GtkScrolledWindow. It replaces the ::set_scroll_adjustment signal. The scrollable interface also has ::min-display-width/height properties that can be used to control the minimally visible part inside a scrolled window.
2010-10-18 04:21:39 +00:00
/* gtkscrollable.h
* Copyright (C) 2008 Tadej Borovšak <tadeboro@gmail.com>
*
* 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
Change FSF Address
2012-02-27 13:01:10 +00:00
* License along with this library. If not, see <http://www.gnu.org/licenses/>.
Add GtkScrollable interface The GtkScrollable interface provides "hadjustment" and "vadjustment" properties that are used by GtkScrolledWindow. It replaces the ::set_scroll_adjustment signal. The scrollable interface also has ::min-display-width/height properties that can be used to control the minimally visible part inside a scrolled window.
2010-10-18 04:21:39 +00:00
*/
Move single-include guards inside include guards gcc has optimizations for include guards that only work if they are outermost in the the header. https://bugzilla.gnome.org/show_bug.cgi?id=689810
2012-12-28 14:57:34 +00:00
#ifndef __GTK_SCROLLABLE_H__
#define __GTK_SCROLLABLE_H__
Add GtkScrollable interface The GtkScrollable interface provides "hadjustment" and "vadjustment" properties that are used by GtkScrolledWindow. It replaces the ::set_scroll_adjustment signal. The scrollable interface also has ::min-display-width/height properties that can be used to control the minimally visible part inside a scrolled window.
2010-10-18 04:21:39 +00:00
#if !defined (__GTK_H_INSIDE__) && !defined (GTK_COMPILATION)
#error "Only <gtk/gtk.h> can be included directly."
#endif
Add annotations to gtk headers Add annotations to all exported functions in GTK+ headers.
2013-03-20 22:17:32 +00:00
#include <gdk/gdk.h>
Added GtkScrollablePolicy property to scrollable interface This patch adds the GtkScrollablePolicy type property to GtkScrollable and implements it in all subclasses. GtkScrolledWindow observes this property to make a good guess about when to show/hide scrollbars for height-for-width content. Most scrollable children do not do height-for-width *yet* but most certainly will (toolpalette, treeview, iconview, textview widgets all TODO), for scrollable widgets that do have a minimum and natural size, it's important for them to observe the state of this property in order to properly drive the scroll adjustments according to the desired GtkScrollablePolicy. This patch makes GtkViewport do this. Patch also adds tests/testscrolledwindow.c to display the effects of this property.
2010-10-26 00:59:02 +00:00
#include <gtk/gtkenums.h>
types: Move GtkAdustment declaration to gtktypes.h ... and make all the headers to not include gtkadjustment.h anymore. Of course, also include it in the source files instead.
2012-03-03 18:41:55 +00:00
#include <gtk/gtktypes.h>
Add a gtk_scrollable_get_border Add a vfunc to return a non-scrollable border around scrollables. This would be nicer as a property, but we can't add properties to an interface without breaking 3rd party implementations, so make this an optional vfunc, and handle it not being set.
2014-12-10 11:45:21 +00:00
#include <gtk/gtkborder.h>
Add GtkScrollable interface The GtkScrollable interface provides "hadjustment" and "vadjustment" properties that are used by GtkScrolledWindow. It replaces the ::set_scroll_adjustment signal. The scrollable interface also has ::min-display-width/height properties that can be used to control the minimally visible part inside a scrolled window.
2010-10-18 04:21:39 +00:00
G_BEGIN_DECLS
#define GTK_TYPE_SCROLLABLE (gtk_scrollable_get_type ())
#define GTK_SCROLLABLE(obj) (G_TYPE_CHECK_INSTANCE_CAST ((obj), GTK_TYPE_SCROLLABLE, GtkScrollable))
#define GTK_IS_SCROLLABLE(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GTK_TYPE_SCROLLABLE))
#define GTK_SCROLLABLE_GET_IFACE(inst) (G_TYPE_INSTANCE_GET_INTERFACE ((inst), GTK_TYPE_SCROLLABLE, GtkScrollableInterface))
typedef struct _GtkScrollable GtkScrollable; /* Dummy */
typedef struct _GtkScrollableInterface GtkScrollableInterface;
struct _GtkScrollableInterface
{
GTypeInterface base_iface;
Add a gtk_scrollable_get_border Add a vfunc to return a non-scrollable border around scrollables. This would be nicer as a property, but we can't add properties to an interface without breaking 3rd party implementations, so make this an optional vfunc, and handle it not being set.
2014-12-10 11:45:21 +00:00
gboolean (* get_border) (GtkScrollable *scrollable,
GtkBorder *border);
Add GtkScrollable interface The GtkScrollable interface provides "hadjustment" and "vadjustment" properties that are used by GtkScrolledWindow. It replaces the ::set_scroll_adjustment signal. The scrollable interface also has ::min-display-width/height properties that can be used to control the minimally visible part inside a scrolled window.
2010-10-18 04:21:39 +00:00
};
/* Public API */
Add annotations to gtk headers Add annotations to all exported functions in GTK+ headers.
2013-03-20 22:17:32 +00:00
GDK_AVAILABLE_IN_ALL
Added GtkScrollablePolicy property to scrollable interface This patch adds the GtkScrollablePolicy type property to GtkScrollable and implements it in all subclasses. GtkScrolledWindow observes this property to make a good guess about when to show/hide scrollbars for height-for-width content. Most scrollable children do not do height-for-width *yet* but most certainly will (toolpalette, treeview, iconview, textview widgets all TODO), for scrollable widgets that do have a minimum and natural size, it's important for them to observe the state of this property in order to properly drive the scroll adjustments according to the desired GtkScrollablePolicy. This patch makes GtkViewport do this. Patch also adds tests/testscrolledwindow.c to display the effects of this property.
2010-10-26 00:59:02 +00:00
GType gtk_scrollable_get_type (void) G_GNUC_CONST;
Add annotations to gtk headers Add annotations to all exported functions in GTK+ headers.
2013-03-20 22:17:32 +00:00
GDK_AVAILABLE_IN_ALL
Added GtkScrollablePolicy property to scrollable interface This patch adds the GtkScrollablePolicy type property to GtkScrollable and implements it in all subclasses. GtkScrolledWindow observes this property to make a good guess about when to show/hide scrollbars for height-for-width content. Most scrollable children do not do height-for-width *yet* but most certainly will (toolpalette, treeview, iconview, textview widgets all TODO), for scrollable widgets that do have a minimum and natural size, it's important for them to observe the state of this property in order to properly drive the scroll adjustments according to the desired GtkScrollablePolicy. This patch makes GtkViewport do this. Patch also adds tests/testscrolledwindow.c to display the effects of this property.
2010-10-26 00:59:02 +00:00
GtkAdjustment *gtk_scrollable_get_hadjustment (GtkScrollable *scrollable);
Add annotations to gtk headers Add annotations to all exported functions in GTK+ headers.
2013-03-20 22:17:32 +00:00
GDK_AVAILABLE_IN_ALL
Added GtkScrollablePolicy property to scrollable interface This patch adds the GtkScrollablePolicy type property to GtkScrollable and implements it in all subclasses. GtkScrolledWindow observes this property to make a good guess about when to show/hide scrollbars for height-for-width content. Most scrollable children do not do height-for-width *yet* but most certainly will (toolpalette, treeview, iconview, textview widgets all TODO), for scrollable widgets that do have a minimum and natural size, it's important for them to observe the state of this property in order to properly drive the scroll adjustments according to the desired GtkScrollablePolicy. This patch makes GtkViewport do this. Patch also adds tests/testscrolledwindow.c to display the effects of this property.
2010-10-26 00:59:02 +00:00
void gtk_scrollable_set_hadjustment (GtkScrollable *scrollable,
GtkAdjustment *hadjustment);
Add annotations to gtk headers Add annotations to all exported functions in GTK+ headers.
2013-03-20 22:17:32 +00:00
GDK_AVAILABLE_IN_ALL
Added GtkScrollablePolicy property to scrollable interface This patch adds the GtkScrollablePolicy type property to GtkScrollable and implements it in all subclasses. GtkScrolledWindow observes this property to make a good guess about when to show/hide scrollbars for height-for-width content. Most scrollable children do not do height-for-width *yet* but most certainly will (toolpalette, treeview, iconview, textview widgets all TODO), for scrollable widgets that do have a minimum and natural size, it's important for them to observe the state of this property in order to properly drive the scroll adjustments according to the desired GtkScrollablePolicy. This patch makes GtkViewport do this. Patch also adds tests/testscrolledwindow.c to display the effects of this property.
2010-10-26 00:59:02 +00:00
GtkAdjustment *gtk_scrollable_get_vadjustment (GtkScrollable *scrollable);
Add annotations to gtk headers Add annotations to all exported functions in GTK+ headers.
2013-03-20 22:17:32 +00:00
GDK_AVAILABLE_IN_ALL
Added GtkScrollablePolicy property to scrollable interface This patch adds the GtkScrollablePolicy type property to GtkScrollable and implements it in all subclasses. GtkScrolledWindow observes this property to make a good guess about when to show/hide scrollbars for height-for-width content. Most scrollable children do not do height-for-width *yet* but most certainly will (toolpalette, treeview, iconview, textview widgets all TODO), for scrollable widgets that do have a minimum and natural size, it's important for them to observe the state of this property in order to properly drive the scroll adjustments according to the desired GtkScrollablePolicy. This patch makes GtkViewport do this. Patch also adds tests/testscrolledwindow.c to display the effects of this property.
2010-10-26 00:59:02 +00:00
void gtk_scrollable_set_vadjustment (GtkScrollable *scrollable,
GtkAdjustment *vadjustment);
Add annotations to gtk headers Add annotations to all exported functions in GTK+ headers.
2013-03-20 22:17:32 +00:00
GDK_AVAILABLE_IN_ALL
Added GtkScrollablePolicy property to scrollable interface This patch adds the GtkScrollablePolicy type property to GtkScrollable and implements it in all subclasses. GtkScrolledWindow observes this property to make a good guess about when to show/hide scrollbars for height-for-width content. Most scrollable children do not do height-for-width *yet* but most certainly will (toolpalette, treeview, iconview, textview widgets all TODO), for scrollable widgets that do have a minimum and natural size, it's important for them to observe the state of this property in order to properly drive the scroll adjustments according to the desired GtkScrollablePolicy. This patch makes GtkViewport do this. Patch also adds tests/testscrolledwindow.c to display the effects of this property.
2010-10-26 00:59:02 +00:00
GtkScrollablePolicy gtk_scrollable_get_hscroll_policy (GtkScrollable *scrollable);
Add annotations to gtk headers Add annotations to all exported functions in GTK+ headers.
2013-03-20 22:17:32 +00:00
GDK_AVAILABLE_IN_ALL
Added GtkScrollablePolicy property to scrollable interface This patch adds the GtkScrollablePolicy type property to GtkScrollable and implements it in all subclasses. GtkScrolledWindow observes this property to make a good guess about when to show/hide scrollbars for height-for-width content. Most scrollable children do not do height-for-width *yet* but most certainly will (toolpalette, treeview, iconview, textview widgets all TODO), for scrollable widgets that do have a minimum and natural size, it's important for them to observe the state of this property in order to properly drive the scroll adjustments according to the desired GtkScrollablePolicy. This patch makes GtkViewport do this. Patch also adds tests/testscrolledwindow.c to display the effects of this property.
2010-10-26 00:59:02 +00:00
void gtk_scrollable_set_hscroll_policy (GtkScrollable *scrollable,
GtkScrollablePolicy policy);
Add annotations to gtk headers Add annotations to all exported functions in GTK+ headers.
2013-03-20 22:17:32 +00:00
GDK_AVAILABLE_IN_ALL
Added GtkScrollablePolicy property to scrollable interface This patch adds the GtkScrollablePolicy type property to GtkScrollable and implements it in all subclasses. GtkScrolledWindow observes this property to make a good guess about when to show/hide scrollbars for height-for-width content. Most scrollable children do not do height-for-width *yet* but most certainly will (toolpalette, treeview, iconview, textview widgets all TODO), for scrollable widgets that do have a minimum and natural size, it's important for them to observe the state of this property in order to properly drive the scroll adjustments according to the desired GtkScrollablePolicy. This patch makes GtkViewport do this. Patch also adds tests/testscrolledwindow.c to display the effects of this property.
2010-10-26 00:59:02 +00:00
GtkScrollablePolicy gtk_scrollable_get_vscroll_policy (GtkScrollable *scrollable);
Add annotations to gtk headers Add annotations to all exported functions in GTK+ headers.
2013-03-20 22:17:32 +00:00
GDK_AVAILABLE_IN_ALL
Added GtkScrollablePolicy property to scrollable interface This patch adds the GtkScrollablePolicy type property to GtkScrollable and implements it in all subclasses. GtkScrolledWindow observes this property to make a good guess about when to show/hide scrollbars for height-for-width content. Most scrollable children do not do height-for-width *yet* but most certainly will (toolpalette, treeview, iconview, textview widgets all TODO), for scrollable widgets that do have a minimum and natural size, it's important for them to observe the state of this property in order to properly drive the scroll adjustments according to the desired GtkScrollablePolicy. This patch makes GtkViewport do this. Patch also adds tests/testscrolledwindow.c to display the effects of this property.
2010-10-26 00:59:02 +00:00
void gtk_scrollable_set_vscroll_policy (GtkScrollable *scrollable,
GtkScrollablePolicy policy);
Add GtkScrollable interface The GtkScrollable interface provides "hadjustment" and "vadjustment" properties that are used by GtkScrolledWindow. It replaces the ::set_scroll_adjustment signal. The scrollable interface also has ::min-display-width/height properties that can be used to control the minimally visible part inside a scrolled window.
2010-10-18 04:21:39 +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 a gtk_scrollable_get_border Add a vfunc to return a non-scrollable border around scrollables. This would be nicer as a property, but we can't add properties to an interface without breaking 3rd party implementations, so make this an optional vfunc, and handle it not being set.
2014-12-10 11:45:21 +00:00
gboolean gtk_scrollable_get_border (GtkScrollable *scrollable,
GtkBorder *border);
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(GtkScrollable, g_object_unref)
Add GtkScrollable interface The GtkScrollable interface provides "hadjustment" and "vadjustment" properties that are used by GtkScrolledWindow. It replaces the ::set_scroll_adjustment signal. The scrollable interface also has ::min-display-width/height properties that can be used to control the minimally visible part inside a scrolled window.
2010-10-18 04:21:39 +00:00
G_END_DECLS
#endif /* __GTK_SCROLLABLE_H__ */
Reference in New Issue Copy Permalink