gtk.RecentChooserDialog — Displays recently used files in a dialog (new in PyGTK 2.10)
class gtk.RecentChooserDialog(gtk.Dialog, gtk.RecentChooser): |
+--gobject.GObject +-- gtk.Object +-- gtk.Widget +-- gtk.Container +-- gtk.Bin +-- gtk.Window +-- gtk.Dialog +-- gtk.RecentChooserDialog
gtk.RecentChooserDialog
is a dialog box suitable for displaying the recently used documents.
This widgets works by putting a gtk.RecentChooserWidget
inside a gtk.Dialog
. It
exposes the gtk.RecentChooser
interface, so you can use all the gtk.RecentChooser
methods on the recent chooser dialog as well as those for gtk.Dialog
.
Note that gtk.RecentChooserDialog
does not have any methods of its own. Instead, you should use the
methods that work on a gtk.RecentChooser
.
Example 4. Typical usage
In the simplest of cases, you can use the following code to use
a gtk.RecentChooserDialog
to select a recently used file:
dialog = gtk.RecentChooserDialog("Recent Documents", parent_window, None, (gtk.STOCK_CANCEL, gtk.RESPONSE_CANCEL, gtk.STOCK_OPEN, gtk.RESPONSE_ACCEPT)) if dialog.run() == gtk.RESPONSE_ACCEPT: info = dialog.get_current_item () open_file(info.get_uri()) dialog.destroy()
Recently used files are supported since GTK+ 2.10.
gtk.RecentChooserDialog(title
=None, parent
=None, manager
=None, buttons
=None)
| Title of the dialog, or
None |
| Transient parent of the dialog, or
None , |
| a gtk.RecentManager ,
or None , |
| a sequence of text-response pairs |
Returns : | a new gtk.RecentChooserDialog |
This constructor is available in PyGTK 2.10 and above.
Creates a new gtk.RecentChooserDialog
with the title text specified by title
(or
None
for the default title; see gtk.Window.set_title
())
and transient parent window specified by parent
(or None
for none; see gtk.Window.set_transient_for
()).
manager
specifies a gtk.RecentManager
object (or None
). buttons
is
a sequence of button text/response ID pairs should be listed, or
None
(the default value) if no buttons are
needed. The button text can be either a stock ID such as
gtk.STOCK_OK
, or some arbitrary text. A response
ID can be any positive number, or one of the pre-defined GTK Response Type Constants. This constructor
is analogous to gtk.Dialog
.