1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
|
/* -*- Mode: C; indent-tabs-mode: t; c-basic-offset: 8; tab-width: 8 -*- */
/* eel-gtk-container.c - Functions to simplify the implementations of
GtkContainer widgets.
Copyright (C) 2001 Ramiro Estrugo.
The Mate Library is free software; you can redistribute it and/or
modify it under the terms of the GNU Library General Public License as
published by the Free Software Foundation; either version 2 of the
License, or (at your option) any later version.
The Mate 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
Library General Public License for more details.
You should have received a copy of the GNU Library General Public
License along with the Mate Library; see the file COPYING.LIB. If not,
write to the Free Software Foundation, Inc., 51 Franklin St, Fifth Floor,
Boston, MA 02110-1301, USA.
Authors: Ramiro Estrugo <ramiro@eazel.com>
*/
#include <config.h>
#include "eel-gtk-container.h"
#include "eel-art-extensions.h"
/**
* eel_gtk_container_child_expose_event:
*
* @container: A GtkContainer widget.
* @child: A child of @container or NULL;
* @event: The expose event.
*
* Forward an expose event to a child if needed. It is valid to give a NULL @child.
* In that case this function is a noop. Proper clipping is done to ensure that the @child
* does indeed need to be forwarded the exposure event. Finally, the forwarding
* only occurs if the child is a NO_WINDOW widget. Of course, it is valid to feed
* non NO_WINDOW widgets to this function, in which case this function is a noop.
*/
void
eel_gtk_container_child_expose_event (GtkContainer *container,
GtkWidget *child,
#if GTK_CHECK_VERSION (3, 0, 0)
cairo_t *cr)
#else
GdkEventExpose *event)
#endif
{
g_return_if_fail (GTK_IS_CONTAINER (container));
if (child == NULL)
{
return;
}
g_return_if_fail (GTK_IS_WIDGET (child));
#if GTK_CHECK_VERSION (3, 0, 0)
gtk_container_propagate_draw (container, child, cr);
#else
gtk_container_propagate_expose (container, child, event);
#endif
}
/**
* eel_gtk_container_child_map:
*
* @container: A GtkContainer widget.
* @child: A child of @container or NULL;
*
* Map a child if needed. This is usually called from the "GtkWidget::map"
* method of the @container widget. If @child is NULL, then this function is a noop.
*/
void
eel_gtk_container_child_map (GtkContainer *container,
GtkWidget *child)
{
g_return_if_fail (GTK_IS_CONTAINER (container));
if (child == NULL)
{
return;
}
g_return_if_fail (gtk_widget_get_parent (child) == GTK_WIDGET (container));
if (gtk_widget_get_visible (child) && !gtk_widget_get_mapped (child))
{
gtk_widget_map (child);
}
}
/**
* eel_gtk_container_child_unmap:
*
* @container: A GtkContainer widget.
* @child: A child of @container or NULL;
*
* Unmap a child if needed. This is usually called from the "GtkWidget::unmap"
* method of the @container widget. If @child is NULL, then this function is a noop.
*/
void
eel_gtk_container_child_unmap (GtkContainer *container,
GtkWidget *child)
{
g_return_if_fail (GTK_IS_CONTAINER (container));
if (child == NULL)
{
return;
}
g_return_if_fail (gtk_widget_get_parent (child) == GTK_WIDGET (container));
if (gtk_widget_get_visible (child) && gtk_widget_get_mapped (child))
{
gtk_widget_unmap (child);
}
}
/**
* eel_gtk_container_child_add:
*
* @container: A GtkContainer widget.
* @child: A non NULL unparented child.
*
* Add a @child to a @container. The @child is realized, mapped
* and resized if needed. This is usually called from the "GtkContainer::add"
* method of the @container. The @child cannot be NULL.
*/
void
eel_gtk_container_child_add (GtkContainer *container,
GtkWidget *child)
{
GtkWidget *widget;
g_return_if_fail (GTK_IS_CONTAINER (container));
g_return_if_fail (GTK_IS_WIDGET (child));
widget = GTK_WIDGET (container);
gtk_widget_set_parent (child, widget);
if (gtk_widget_get_realized (widget))
{
gtk_widget_realize (child);
}
if (gtk_widget_get_mapped (widget)
&& gtk_widget_get_visible (child))
{
if (gtk_widget_get_mapped (widget))
{
gtk_widget_map (child);
}
gtk_widget_queue_resize (child);
}
}
/**
* eel_gtk_container_child_remove:
*
* @container: A GtkContainer widget.
* @child: A non NULL child of @container.
*
* Remove @child from @container. The @container is resized if needed.
* This is usually called from the "GtkContainer::remove" method of the
* @container. The child cannot be NULL.
*/
void
eel_gtk_container_child_remove (GtkContainer *container,
GtkWidget *child)
{
gboolean child_was_visible;
g_return_if_fail (GTK_IS_CONTAINER (container));
g_return_if_fail (GTK_IS_WIDGET (child));
g_return_if_fail (gtk_widget_get_parent (child) == GTK_WIDGET (container));
child_was_visible = gtk_widget_get_visible (child);
gtk_widget_unparent (child);
if (child_was_visible)
{
gtk_widget_queue_resize (GTK_WIDGET (container));
}
}
/**
* eel_gtk_container_child_size_allocate:
*
* @container: A GtkContainer widget.
* @child: A child of @container or NULL;
*
* Invoke the "GtkWidget::size_allocate" method of @child.
* This function is usually called from the "GtkWidget::size_allocate"
* method of @container. The child can be NULL, in which case this
* function is a noop.
*/
void
eel_gtk_container_child_size_allocate (GtkContainer *container,
GtkWidget *child,
EelIRect child_geometry)
{
GtkAllocation child_allocation;
g_return_if_fail (GTK_IS_CONTAINER (container));
if (child == NULL)
{
return;
}
g_return_if_fail (GTK_IS_WIDGET (child));
g_return_if_fail (gtk_widget_get_parent (child) == GTK_WIDGET (container));
if (eel_irect_is_empty (&child_geometry))
{
return;
}
child_allocation.x = child_geometry.x0;
child_allocation.y = child_geometry.y0;
child_allocation.width = eel_irect_get_width (child_geometry);
child_allocation.height = eel_irect_get_height (child_geometry);
gtk_widget_size_allocate (child, &child_allocation);
}
|
