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
234
|
// -*- c++ -*-
// Generated by gtkmmproc -- DO NOT MODIFY!
#ifndef _GTKMM_FILECHOOSERBUTTON_H
#define _GTKMM_FILECHOOSERBUTTON_H
#include <glibmm.h>
/* $Id$ */
/* filechooserbutton.h
*
* Copyright (C) 2003 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/box.h>
#include <gtkmm/filechooserdialog.h>
#ifndef DOXYGEN_SHOULD_SKIP_THIS
typedef struct _GtkFileChooserButton GtkFileChooserButton;
typedef struct _GtkFileChooserButtonClass GtkFileChooserButtonClass;
#endif /* DOXYGEN_SHOULD_SKIP_THIS */
namespace Gtk
{ class FileChooserButton_Class; } // namespace Gtk
namespace Gtk
{
/** A button to launch a file chooser dialog.
*
* This widget lets the user select a file. It implements the FileChooser interface. Visually, it is a file name with a
* button to bring up a FileChooserDialog. The user can then use that dialog to change the file associated with that
* button. This widget does not support setting the "select_multiple" property to true.
*
* The FileChooserButton supports the FileChooserActions FILE_CHOOSER_ACTION_OPEN and FILE_CHOOSER_ACTION_SELECT_FOLDER.
*
* The FileChooserButton will ellipsize the label, and will thus request little horizontal space. To give the button more
* space, you should call size_request(), set_width_chars(), or pack the button in such a way that other interface
* elements give space to the widget.
*
* @ingroup Widgets
*/
class FileChooserButton
: public HBox,
public FileChooser
{
public:
#ifndef DOXYGEN_SHOULD_SKIP_THIS
typedef FileChooserButton CppObjectType;
typedef FileChooserButton_Class CppClassType;
typedef GtkFileChooserButton BaseObjectType;
typedef GtkFileChooserButtonClass BaseClassType;
#endif /* DOXYGEN_SHOULD_SKIP_THIS */
virtual ~FileChooserButton();
#ifndef DOXYGEN_SHOULD_SKIP_THIS
private:
friend class FileChooserButton_Class;
static CppClassType filechooserbutton_class_;
// noncopyable
FileChooserButton(const FileChooserButton&);
FileChooserButton& operator=(const FileChooserButton&);
protected:
explicit FileChooserButton(const Glib::ConstructParams& construct_params);
explicit FileChooserButton(GtkFileChooserButton* 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.
GtkFileChooserButton* gobj() { return reinterpret_cast<GtkFileChooserButton*>(gobject_); }
///Provides access to the underlying C GtkObject.
const GtkFileChooserButton* gobj() const { return reinterpret_cast<GtkFileChooserButton*>(gobject_); }
public:
//C++ methods used to invoke GTK+ virtual functions:
protected:
//GTK+ Virtual Functions (override these to change behaviour):
//Default Signal Handlers::
private:
public:
/** Creates a new file-selecting button widget with the default title.
* @param title The title of the browse dialog.
* @param action The open mode for the widget.
* @param backend The name of the Gtk::FileSystem backend to use.
*/
explicit FileChooserButton(FileChooserAction action = FILE_CHOOSER_ACTION_OPEN);
/** Creates a new file-selecting button widget.
*
* @param title The title of the browse dialog.
* @param action The open mode for the widget.
*/
explicit FileChooserButton(const Glib::ustring& title, FileChooserAction action = FILE_CHOOSER_ACTION_OPEN);
/** Creates a new file-selecting button widget using backend.
*
* @param title The title of the browse dialog.
* @param action The open mode for the widget.
* @param backend The name of the Gtk::FileSystem backend to use.
*/
explicit FileChooserButton(const Glib::ustring& title, FileChooserAction action, const Glib::ustring& backend);
/** Creates a new file-selecting button widget which uses dialog as its file-picking window.
*
* @param dialog The dialog to use.
*/
explicit FileChooserButton(FileChooserDialog& dialog);
/** Retrieves the title of the browse dialog used by @a button . The returned value
* should not be modified or freed.
* @return A pointer to the browse dialog's title.
*
* Since: 2.6.
*/
Glib::ustring get_title() const;
/** Modifies the @a title of the browse dialog used by @a button .
*
* Since: 2.6
* @param title The new browse dialog title.
*/
void set_title(const Glib::ustring& title);
/** Retrieves the width in characters of the @a button widget's entry and/or label.
* @return An integer width (in characters) that the button will use to size itself.
*
* Since: 2.6.
*/
int get_width_chars() const;
/** Sets the width (in characters) that @a button will use to @a n_chars .
*
* Since: 2.6
* @param n_chars The new width, in chracters.
*/
void set_width_chars(int n_chars);
/** The file chooser dialog to use.
*
* 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<FileChooserDialog*> property_dialog() const;
/** The title of the file chooser dialog.
*
* 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<Glib::ustring> property_title() ;
/** The title of the file chooser dialog.
*
* 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<Glib::ustring> property_title() const;
/** The desired width of the button widget
*
* 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<int> property_width_chars() ;
/** The desired width of the button widget
*
* 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<int> property_width_chars() const;
};
} // namespace Gtk
namespace Glib
{
/** @relates Gtk::FileChooserButton
* @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::FileChooserButton* wrap(GtkFileChooserButton* object, bool take_copy = false);
}
#endif /* _GTKMM_FILECHOOSERBUTTON_H */
|
