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
|
// -*- c++ -*-
// Generated by gtkmmproc -- DO NOT MODIFY!
#ifndef _GTKMM_EVENTBOX_H
#define _GTKMM_EVENTBOX_H
#include <glibmm.h>
/* $Id$ */
/* eventbox.h
*
* Copyright (C) 1998-2002 The gtkmm Development Team
*
* This 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.
*
* 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
* Library General Public License for more details.
*
* You should have received a copy of the GNU Library General Public
* License along with this library; if not, write to the Free
* Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
*/
#include <gtkmm/bin.h>
#ifndef DOXYGEN_SHOULD_SKIP_THIS
typedef struct _GtkEventBox GtkEventBox;
typedef struct _GtkEventBoxClass GtkEventBoxClass;
#endif /* DOXYGEN_SHOULD_SKIP_THIS */
namespace Gtk
{ class EventBox_Class; } // namespace Gtk
namespace Gtk
{
/** Event capturing box.
*
* This widget adds an X Window where one does not
* normally appear, allowing you to capture events.
* It will receive any event which is specified
* with set_events().
*
* This widget is generally used to add Gtk::Tooltips, button presses,
* and clipping to widgets derived from Gtk::Misc.
*
* @ingroup Widgets
*/
class EventBox : public Bin
{
public:
#ifndef DOXYGEN_SHOULD_SKIP_THIS
typedef EventBox CppObjectType;
typedef EventBox_Class CppClassType;
typedef GtkEventBox BaseObjectType;
typedef GtkEventBoxClass BaseClassType;
#endif /* DOXYGEN_SHOULD_SKIP_THIS */
virtual ~EventBox();
#ifndef DOXYGEN_SHOULD_SKIP_THIS
private:
friend class EventBox_Class;
static CppClassType eventbox_class_;
// noncopyable
EventBox(const EventBox&);
EventBox& operator=(const EventBox&);
protected:
explicit EventBox(const Glib::ConstructParams& construct_params);
explicit EventBox(GtkEventBox* castitem);
#endif /* DOXYGEN_SHOULD_SKIP_THIS */
public:
#ifndef DOXYGEN_SHOULD_SKIP_THIS
static GType get_type() G_GNUC_CONST;
static GType get_base_type() G_GNUC_CONST;
#endif
///Provides access to the underlying C GtkObject.
GtkEventBox* gobj() { return reinterpret_cast<GtkEventBox*>(gobject_); }
///Provides access to the underlying C GtkObject.
const GtkEventBox* gobj() const { return reinterpret_cast<GtkEventBox*>(gobject_); }
public:
//C++ methods used to invoke GTK+ virtual functions:
protected:
//GTK+ Virtual Functions (override these to change behaviour):
//Default Signal Handlers::
private:
public:
EventBox();
/** Returns whether the event box has a visible window.
* See set_visible_window() for details.
* @return <tt>true</tt> if the event box window is visible
*
* Since: 2.4.
*/
bool get_visible_window() const;
/** Set whether the event box uses a visible or invisible child
* window. The default is to use visible windows.
*
* In an invisible window event box, the window that that the
* event box creates is a Gdk::INPUT_ONLY window, which
* means that it is invisible and only serves to receive
* events.
*
* A visible window event box creates a visible (Gdk::INPUT_OUTPUT)
* window that acts as the parent window for all the widgets
* contained in the event box.
*
* You should generally make your event box invisible if
* you just want to trap events. Creating a visible window
* may cause artifacts that are visible to the user, especially
* if the user is using a theme with gradients or pixmaps.
*
* The main reason to create a non input-only event box is if
* you want to set the background to a different color or
* draw on it.
*
* <note>
* There is one unexpected issue for an invisible event box that has its
* window below the child. (See set_above_child().)
* Since the input-only window is not an ancestor window of any windows
* that descendent widgets of the event box create, events on these
* windows aren't propagated up by the windowing system, but only by GTK+.
* The practical effect of this is if an event isn't in the event
* mask for the descendant window (see Gtk::Widget::add_events()),
* it won't be received by the event box.
*
* This problem doesn't occur for visible event boxes, because in
* that case, the event box window is actually the ancestor of the
* descendant windows, not just at the same place on the screen.
* </note>
*
* Since: 2.4
* @param visible_window Boolean value.
*/
void set_visible_window(bool visible_window = true);
/** Returns whether the event box window is above or below the
* windows of its child. See set_above_child() for
* details.
* @return <tt>true</tt> if the event box window is above the window
* of its child.
*
* Since: 2.4.
*/
bool get_above_child() const;
/** Set whether the event box window is positioned above the windows of its child,
* as opposed to below it. If the window is above, all events inside the
* event box will go to the event box. If the window is below, events
* in windows of child widgets will first got to that widget, and then
* to its parents.
*
* The default is to keep the window below the child.
*
* Since: 2.4
* @param above_child <tt>true</tt> if the event box window is above the windows of its child.
*/
void set_above_child(bool above_child = true);
/** Whether the event box is visible
*
* You rarely need to use properties because there are get_ and set_ methods for almost all of them.
* @return A PropertyProxy that allows you to get or set the property of the value, or receive notification when
* the value of the property changes.
*/
Glib::PropertyProxy<bool> property_visible_window() ;
/** Whether the event box is visible
*
* You rarely need to use properties because there are get_ and set_ methods for almost all of them.
* @return A PropertyProxy that allows you to get or set the property of the value, or receive notification when
* the value of the property changes.
*/
Glib::PropertyProxy_ReadOnly<bool> property_visible_window() const;
/** Whether the event-trapping window of the eventbox is above the window of the child widget as opposed to below it.
*
* You rarely need to use properties because there are get_ and set_ methods for almost all of them.
* @return A PropertyProxy that allows you to get or set the property of the value, or receive notification when
* the value of the property changes.
*/
Glib::PropertyProxy<bool> property_above_child() ;
/** Whether the event-trapping window of the eventbox is above the window of the child widget as opposed to below it.
*
* You rarely need to use properties because there are get_ and set_ methods for almost all of them.
* @return A PropertyProxy that allows you to get or set the property of the value, or receive notification when
* the value of the property changes.
*/
Glib::PropertyProxy_ReadOnly<bool> property_above_child() const;
};
} /* namespace Gtk */
namespace Glib
{
/** @relates Gtk::EventBox
* @param object The C instance
* @param take_copy False if the result should take ownership of the C instance. True if it should take a new copy or ref.
* @result A C++ instance that wraps this C instance.
*/
Gtk::EventBox* wrap(GtkEventBox* object, bool take_copy = false);
}
#endif /* _GTKMM_EVENTBOX_H */
|
