~ubuntu-branches/ubuntu/precise/gtkmm3.0/precise

« back to all changes in this revision

Viewing changes to gtk/gtkmm/toolshell.h

  • Committer: Bazaar Package Importer
  • Author(s): Michael Biebl
  • Date: 2011-06-17 00:12:44 UTC
  • Revision ID: james.westby@ubuntu.com-20110617001244-9hl5an15hiaaahi6
Tags: upstream-3.0.1
ImportĀ upstreamĀ versionĀ 3.0.1

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
// -*- c++ -*-
 
2
// Generated by gtkmmproc -- DO NOT MODIFY!
 
3
#ifndef _GTKMM_TOOLSHELL_H
 
4
#define _GTKMM_TOOLSHELL_H
 
5
 
 
6
 
 
7
#include <glibmm.h>
 
8
 
 
9
/* $Id: editable.hg,v 1.3 2006/05/18 17:53:15 murrayc Exp $ */
 
10
 
 
11
/* Copyright (C) 1998-2002 The gtkmm Development Team
 
12
 *
 
13
 * This library is free software; you can redistribute it and/or
 
14
 * modify it under the terms of the GNU Lesser General Public
 
15
 * License as published by the Free Software Foundation; either
 
16
 * version 2.1 of the License, or (at your option) any later version.
 
17
 *
 
18
 * This library is distributed in the hope that it will be useful,
 
19
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 
20
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 
21
 * Lesser General Public License for more details.
 
22
 *
 
23
 * You should have received a copy of the GNU Lesser General Public
 
24
 * License along with this library; if not, write to the Free
 
25
 * Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
 
26
 */
 
27
 
 
28
#include <glibmm/interface.h>
 
29
#include <gtkmm/enums.h>
 
30
#include <gtkmm/sizegroup.h>
 
31
 
 
32
 
 
33
#ifndef DOXYGEN_SHOULD_SKIP_THIS
 
34
extern "C"
 
35
{
 
36
typedef struct _GtkToolShellIface GtkToolShellIface;
 
37
}
 
38
#endif /* DOXYGEN_SHOULD_SKIP_THIS */
 
39
 
 
40
#ifndef DOXYGEN_SHOULD_SKIP_THIS
 
41
typedef struct _GtkToolShell GtkToolShell;
 
42
typedef struct _GtkToolShellClass GtkToolShellClass;
 
43
#endif /* DOXYGEN_SHOULD_SKIP_THIS */
 
44
 
 
45
 
 
46
namespace Gtk
 
47
{ class ToolShell_Class; } // namespace Gtk
 
48
namespace Gtk
 
49
{
 
50
 
 
51
/** A base class for containers containing ToolItem widgets.
 
52
 * This interface allows container widgets to provide additional information when embedding ToolItem widgets. 
 
53
 *
 
54
 * @newin{2,14}
 
55
 */
 
56
 
 
57
class ToolShell : public Glib::Interface
 
58
{
 
59
  
 
60
#ifndef DOXYGEN_SHOULD_SKIP_THIS
 
61
 
 
62
public:
 
63
  typedef ToolShell CppObjectType;
 
64
  typedef ToolShell_Class CppClassType;
 
65
  typedef GtkToolShell BaseObjectType;
 
66
  typedef GtkToolShellIface BaseClassType;
 
67
 
 
68
private:
 
69
  friend class ToolShell_Class;
 
70
  static CppClassType toolshell_class_;
 
71
 
 
72
  // noncopyable
 
73
  ToolShell(const ToolShell&);
 
74
  ToolShell& operator=(const ToolShell&);
 
75
 
 
76
protected:
 
77
  ToolShell(); // you must derive from this class
 
78
 
 
79
  /** Called by constructors of derived classes. Provide the result of 
 
80
   * the Class init() function to ensure that it is properly 
 
81
   * initialized.
 
82
   * 
 
83
   * @param interface_class The Class object for the derived type.
 
84
   */
 
85
  explicit ToolShell(const Glib::Interface_Class& interface_class);
 
86
 
 
87
public:
 
88
  // This is public so that C++ wrapper instances can be
 
89
  // created for C instances of unwrapped types.
 
90
  // For instance, if an unexpected C type implements the C interface. 
 
91
  explicit ToolShell(GtkToolShell* castitem);
 
92
 
 
93
protected:
 
94
#endif /* DOXYGEN_SHOULD_SKIP_THIS */
 
95
 
 
96
public:
 
97
  virtual ~ToolShell();
 
98
 
 
99
  static void add_interface(GType gtype_implementer);
 
100
 
 
101
#ifndef DOXYGEN_SHOULD_SKIP_THIS
 
102
  static GType get_type()      G_GNUC_CONST;
 
103
  static GType get_base_type() G_GNUC_CONST;
 
104
#endif
 
105
 
 
106
  ///Provides access to the underlying C GObject.
 
107
  GtkToolShell*       gobj()       { return reinterpret_cast<GtkToolShell*>(gobject_); }
 
108
 
 
109
  ///Provides access to the underlying C GObject.  
 
110
  const GtkToolShell* gobj() const { return reinterpret_cast<GtkToolShell*>(gobject_); }
 
111
 
 
112
private:
 
113
 
 
114
 
 
115
public:
 
116
  
 
117
  /** Retrieves the icon size for the tool shell. Tool items must not call this
 
118
   * function directly, but rely on Gtk::ToolItem::get_icon_size() instead.
 
119
   * 
 
120
   * @newin{2,14}
 
121
   * @return The current size for icons of @a shell.
 
122
   */
 
123
  IconSize get_icon_size() const;
 
124
  
 
125
  /** Retrieves the current orientation for the tool shell. Tool items must not
 
126
   * call this function directly, but rely on Gtk::ToolItem::get_orientation()
 
127
   * instead.
 
128
   * 
 
129
   * @newin{2,14}
 
130
   * @return The current orientation of @a shell.
 
131
   */
 
132
  Orientation get_orientation() const;
 
133
  
 
134
  /** Retrieves whether the tool shell has text, icons, or both. Tool items must
 
135
   * not call this function directly, but rely on gtk_tool_item_get_style()
 
136
   * instead.
 
137
   * 
 
138
   * @newin{2,14}
 
139
   * @return The current style of @a shell.
 
140
   */
 
141
  ToolbarStyle get_style() const;
 
142
  
 
143
  /** Returns the relief style of buttons on @a shell. Tool items must not call this
 
144
   * function directly, but rely on Gtk::ToolItem::get_relief_style() instead.
 
145
   * 
 
146
   * @newin{2,14}
 
147
   * @return The relief style of buttons on @a shell.
 
148
   */
 
149
  ReliefStyle get_relief_style() const;
 
150
  
 
151
  /** Calling this function signals the tool shell that the overflow menu item for
 
152
   * tool items have changed. If there is an overflow menu and if it is visible
 
153
   * when this function it called, the menu will be rebuilt.
 
154
   * 
 
155
   * Tool items must not call this function directly, but rely on
 
156
   * Gtk::ToolItem::rebuild_menu() instead.
 
157
   * 
 
158
   * @newin{2,14}
 
159
   */
 
160
  void rebuild_menu();
 
161
  
 
162
  /** Retrieves the current text orientation for the tool shell. Tool items must not
 
163
   * call this function directly, but rely on Gtk::ToolItem::get_text_orientation()
 
164
   * instead.
 
165
   * 
 
166
   * @newin{2,20}
 
167
   * @return The current text orientation of @a shell.
 
168
   */
 
169
  Orientation get_text_orientation() const;
 
170
  
 
171
  /** Retrieves the current text alignment for the tool shell. Tool items must not
 
172
   * call this function directly, but rely on Gtk::ToolItem::get_text_alignment()
 
173
   * instead.
 
174
   * 
 
175
   * @newin{2,20}
 
176
   * @return The current text alignment of @a shell.
 
177
   */
 
178
  float get_text_alignment() const;
 
179
  
 
180
  /** Retrieves the current ellipsize mode for the tool shell. Tool items must not
 
181
   * call this function directly, but rely on Gtk::ToolItem::get_ellipsize_mode()
 
182
   * instead.
 
183
   * 
 
184
   * @newin{2,20}
 
185
   * @return The current ellipsize mode of @a shell.
 
186
   */
 
187
  Pango::EllipsizeMode get_ellipsize_mode() const;
 
188
 
 
189
  
 
190
  /** Retrieves the current text size group for the tool shell. Tool items must not
 
191
   * call this function directly, but rely on Gtk::ToolItem::get_text_size_group()
 
192
   * instead.
 
193
   * 
 
194
   * @newin{2,20}
 
195
   * @return The current text size group of @a shell.
 
196
   */
 
197
  Glib::RefPtr<SizeGroup> get_text_size_group();
 
198
  
 
199
  /** Retrieves the current text size group for the tool shell. Tool items must not
 
200
   * call this function directly, but rely on Gtk::ToolItem::get_text_size_group()
 
201
   * instead.
 
202
   * 
 
203
   * @newin{2,20}
 
204
   * @return The current text size group of @a shell.
 
205
   */
 
206
  Glib::RefPtr<const SizeGroup> get_text_size_group() const;
 
207
 
 
208
protected:
 
209
 
 
210
    virtual IconSize get_icon_size_vfunc();
 
211
 
 
212
    virtual Orientation get_orientation_vfunc();
 
213
 
 
214
    virtual ToolbarStyle get_style_vfunc();
 
215
 
 
216
    virtual ReliefStyle get_relief_style_vfunc();
 
217
 
 
218
    virtual void rebuild_menu_vfunc();
 
219
 
 
220
  //TODO: Add the other vfuncs when we can break ABI.
 
221
 
 
222
 
 
223
public:
 
224
 
 
225
public:
 
226
  //C++ methods used to invoke GTK+ virtual functions:
 
227
 
 
228
protected:
 
229
  //GTK+ Virtual Functions (override these to change behaviour):
 
230
 
 
231
  //Default Signal Handlers::
 
232
 
 
233
 
 
234
};
 
235
 
 
236
} // namespace Gtk
 
237
 
 
238
 
 
239
namespace Glib
 
240
{
 
241
  /** A Glib::wrap() method for this object.
 
242
   * 
 
243
   * @param object The C instance.
 
244
   * @param take_copy False if the result should take ownership of the C instance. True if it should take a new copy or ref.
 
245
   * @result A C++ instance that wraps this C instance.
 
246
   *
 
247
   * @relates Gtk::ToolShell
 
248
   */
 
249
  Glib::RefPtr<Gtk::ToolShell> wrap(GtkToolShell* object, bool take_copy = false);
 
250
 
 
251
} // namespace Glib
 
252
 
 
253
 
 
254
#endif /* _GTKMM_TOOLSHELL_H */
 
255