1/* GTK - The GIMP Toolkit
2 * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald
3 *
4 * This library is free software; you can redistribute it and/or
5 * modify it under the terms of the GNU Lesser General Public
6 * License as published by the Free Software Foundation; either
7 * version 2 of the License, or (at your option) any later version.
8 *
9 * This library is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12 * Lesser General Public License for more details.
13 *
14 * You should have received a copy of the GNU Lesser General Public
15 * License along with this library; if not, write to the
16 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
17 * Boston, MA 02111-1307, USA.
18 *
19 * GtkLayout: Widget for scrolling of arbitrary-sized areas.
20 *
21 * Copyright Owen Taylor, 1998
22 */
23
24/*
25 * Modified by the GTK+ Team and others 1997-2000. See the AUTHORS
26 * file for a list of people on the GTK+ Team. See the ChangeLog
27 * files for a list of changes. These files are distributed with
28 * GTK+ at ftp://ftp.gtk.org/pub/gtk/.
29 */
30
31#ifndef __GTK_LAYOUT_H__
32#define __GTK_LAYOUT_H__
33
34
35#if defined(GTK_DISABLE_SINGLE_INCLUDES) && !defined (__GTK_H_INSIDE__) && !defined (GTK_COMPILATION)
36#error "Only <gtk/gtk.h> can be included directly."
37#endif
38
39#include <gtk/gtkcontainer.h>
40#include <gtk/gtkadjustment.h>
41
42
43G_BEGIN_DECLS
44
45#define GTK_TYPE_LAYOUT (gtk_layout_get_type ())
46#define GTK_LAYOUT(obj) (G_TYPE_CHECK_INSTANCE_CAST ((obj), GTK_TYPE_LAYOUT, GtkLayout))
47#define GTK_LAYOUT_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST ((klass), GTK_TYPE_LAYOUT, GtkLayoutClass))
48#define GTK_IS_LAYOUT(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GTK_TYPE_LAYOUT))
49#define GTK_IS_LAYOUT_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), GTK_TYPE_LAYOUT))
50#define GTK_LAYOUT_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS ((obj), GTK_TYPE_LAYOUT, GtkLayoutClass))
51
52
53typedef struct _GtkLayout GtkLayout;
54typedef struct _GtkLayoutClass GtkLayoutClass;
55
56struct _GtkLayout
57{
58 GtkContainer GSEAL (container);
59
60 GList *GSEAL (children);
61
62 guint GSEAL (width);
63 guint GSEAL (height);
64
65 GtkAdjustment *GSEAL (hadjustment);
66 GtkAdjustment *GSEAL (vadjustment);
67
68 /*< public >*/
69 GdkWindow *GSEAL (bin_window);
70
71 /*< private >*/
72 GdkVisibilityState GSEAL (visibility);
73 gint GSEAL (scroll_x);
74 gint GSEAL (scroll_y);
75
76 guint GSEAL (freeze_count);
77};
78
79struct _GtkLayoutClass
80{
81 GtkContainerClass parent_class;
82
83 void (*set_scroll_adjustments) (GtkLayout *layout,
84 GtkAdjustment *hadjustment,
85 GtkAdjustment *vadjustment);
86
87 /* Padding for future expansion */
88 void (*_gtk_reserved1) (void);
89 void (*_gtk_reserved2) (void);
90 void (*_gtk_reserved3) (void);
91 void (*_gtk_reserved4) (void);
92};
93
94GType gtk_layout_get_type (void) G_GNUC_CONST;
95GtkWidget* gtk_layout_new (GtkAdjustment *hadjustment,
96 GtkAdjustment *vadjustment);
97GdkWindow* gtk_layout_get_bin_window (GtkLayout *layout);
98void gtk_layout_put (GtkLayout *layout,
99 GtkWidget *child_widget,
100 gint x,
101 gint y);
102
103void gtk_layout_move (GtkLayout *layout,
104 GtkWidget *child_widget,
105 gint x,
106 gint y);
107
108void gtk_layout_set_size (GtkLayout *layout,
109 guint width,
110 guint height);
111void gtk_layout_get_size (GtkLayout *layout,
112 guint *width,
113 guint *height);
114
115GtkAdjustment* gtk_layout_get_hadjustment (GtkLayout *layout);
116GtkAdjustment* gtk_layout_get_vadjustment (GtkLayout *layout);
117void gtk_layout_set_hadjustment (GtkLayout *layout,
118 GtkAdjustment *adjustment);
119void gtk_layout_set_vadjustment (GtkLayout *layout,
120 GtkAdjustment *adjustment);
121
122
123#ifndef GTK_DISABLE_DEPRECATED
124/* These disable and enable moving and repainting the scrolling window
125 * of the GtkLayout, respectively. If you want to update the layout's
126 * offsets but do not want it to repaint itself, you should use these
127 * functions.
128 *
129 * - I don't understand these are supposed to work, so I suspect
130 * - they don't now. OWT 1/20/98
131 */
132void gtk_layout_freeze (GtkLayout *layout);
133void gtk_layout_thaw (GtkLayout *layout);
134#endif /* GTK_DISABLE_DEPRECATED */
135
136G_END_DECLS
137
138#endif /* __GTK_LAYOUT_H__ */
139