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
|
// -*- c++ -*-
// Generated by gtkmmproc -- DO NOT MODIFY!
#ifndef _GTKMM_MENUITEM_H
#define _GTKMM_MENUITEM_H
#include <glibmm.h>
/* $Id$ */
/* menuitem.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/item.h>
#include <gtkmm/accelkey.h>
#include <gtkmm/accellabel.h>
#ifndef DOXYGEN_SHOULD_SKIP_THIS
typedef struct _GtkMenuItem GtkMenuItem;
typedef struct _GtkMenuItemClass GtkMenuItemClass;
#endif /* DOXYGEN_SHOULD_SKIP_THIS */
namespace Gtk
{ class MenuItem_Class; } // namespace Gtk
namespace Gtk
{
class Menu;
namespace Menu_Helpers { class Element; }
/** Child item for menus.
* Handle highlighting, alignment, events and submenus.
* As it derives from Gtk::Bin it can hold any valid child widget, altough only a few are really useful.
* @ingroup Widgets
* @ingroup Menus
*/
class MenuItem : public Item
{
public:
#ifndef DOXYGEN_SHOULD_SKIP_THIS
typedef MenuItem CppObjectType;
typedef MenuItem_Class CppClassType;
typedef GtkMenuItem BaseObjectType;
typedef GtkMenuItemClass BaseClassType;
#endif /* DOXYGEN_SHOULD_SKIP_THIS */
virtual ~MenuItem();
#ifndef DOXYGEN_SHOULD_SKIP_THIS
private:
friend class MenuItem_Class;
static CppClassType menuitem_class_;
// noncopyable
MenuItem(const MenuItem&);
MenuItem& operator=(const MenuItem&);
protected:
explicit MenuItem(const Glib::ConstructParams& construct_params);
explicit MenuItem(GtkMenuItem* 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.
GtkMenuItem* gobj() { return reinterpret_cast<GtkMenuItem*>(gobject_); }
///Provides access to the underlying C GtkObject.
const GtkMenuItem* gobj() const { return reinterpret_cast<GtkMenuItem*>(gobject_); }
public:
//C++ methods used to invoke GTK+ virtual functions:
protected:
//GTK+ Virtual Functions (override these to change behaviour):
//Default Signal Handlers::
virtual void on_activate();
virtual void on_activate_item();
virtual void on_toggle_size_request(int* requisition);
virtual void on_toggle_size_allocate(int allocation);
private:
public:
/// Create an empty menu item
MenuItem();
/// Create a menu item with widget
explicit MenuItem(Widget& widget);
/// Create a menu item with label
explicit MenuItem(const Glib::ustring& label, bool mnemonic = false);
void set_submenu(Menu& submenu);
/** Gets the submenu underneath this menu item, if any. See
* set_submenu().
* @return Submenu for this menu item, or <tt>0</tt> if none.
*/
Menu* get_submenu();
/** Gets the submenu underneath this menu item, if any. See
* set_submenu().
* @return Submenu for this menu item, or <tt>0</tt> if none.
*/
const Menu* get_submenu() const;
bool has_submenu() const;
void remove_submenu();
void select();
void deselect();
void activate();
void toggle_size_request(int& requisition);
void toggle_size_allocate(int allocation);
/** Sets whether the menu item appears justified at the right
* side of a menu bar. This was traditionally done for "Help" menu
* items, but is now considered a bad idea. (If the widget
* layout is reversed for a right-to-left language like Hebrew
* or Arabic, right-justified-menu-items appear at the left.)
* @param right_justified If <tt>true</tt> the menu item will appear at the
* far right if added to a menu bar.
*/
void set_right_justified(bool right_justified = true);
/** Gets whether the menu item appears justified at the right
* side of the menu bar.
* @return <tt>true</tt> if the menu item will appear at the
* far right if added to a menu bar.
*/
bool get_right_justified() const;
/** Set the accelerator path on @a menu_item , through which runtime changes of the
* menu item's accelerator caused by the user can be identified and saved to
* persistant storage (see gtk_accel_map_save() on this).
* To setup a default accelerator for this menu item, call
* gtk_accel_map_add_entry() with the same @a accel_path .
* See also gtk_accel_map_add_entry() on the specifics of accelerator paths,
* and set_accel_path() for a more convenient variant of this function.
*
* This function is basically a convenience wrapper that handles calling
* Gtk::Widget::set_accel_path() with the appropriate accelerator group for
* the menu item.
*
* Note that you do need to set an accelerator on the parent menu with
* set_accel_group() for this to work.
* @param accel_path Accelerator path, corresponding to this menu item's
* functionality.
*/
void set_accel_path(const Glib::ustring& accel_path);
void unset_accel_path();
Glib::SignalProxy0< void > signal_activate();
Glib::SignalProxy0< void > signal_activate_item();
Glib::SignalProxy1< void,int* > signal_toggle_size_request();
Glib::SignalProxy1< void,int > signal_toggle_size_allocate();
void accelerate(Window& window);
protected:
void add_accel_label(const Glib::ustring& label, bool mnemonic = true);
void set_accel_key(const AccelKey& accel_key);
private:
friend class Menu_Helpers::Element;
//This data is set by MenuElem, and will be used in on_realize(), in the call to add_accelerator().
AccelKey accel_key_;
};
} /* namespace Gtk */
namespace Glib
{
/** @relates Gtk::MenuItem
* @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::MenuItem* wrap(GtkMenuItem* object, bool take_copy = false);
}
#endif /* _GTKMM_MENUITEM_H */
|
