ruby-****@sourc*****
ruby-****@sourc*****
2012年 1月 17日 (火) 04:00:38 JST
-------------------------
REMOTE_ADDR = 184.145.90.60
REMOTE_HOST =
URL = http://ruby-gnome2.sourceforge.jp/hiki.cgi?Gtk%3A%3AFileChooser
-------------------------
@@ -2,12 +2,12 @@
Gtk::FileChooser is a Ruby module (originally in GTK+ C library an interface) that can be implemented by file selection widgets. In GTK+, the main classes that implement this module (interface) are Gtk::FileChooserWidget, Gtk::FileChooserDialog, and Gtk::FileChooserButton. You do not need to write a class that implements the Gtk::FileChooser module unless you are trying to adapt an existing file selector to expose a standard programming interface.
-== Description
+== Description:
=== File Names and Encodings
When the user is finished selecting files in a Gtk::FileChooser, your program can get the selected names either as filenames or as URIs. For URIs, the normal escaping rules are applied if the URI contains non-ASCII characters. However, filenames are always returned in the character set specified by the G_FILENAME_ENCODING environment variable. Please see the Glib documentation for more details about this variable.
-==== Important:
+=== Important:
This means that while you can pass the result of Gtk::FileChooser#filename to open(2) or fopen(3), you may not be able to directly set it as the text of a Gtk::Label widget unless you convert it first to UTF-8, which all GTK+ widgets expect. You should use GLib.filename_to_utf8 to convert filenames into strings that can be passed to GTK+ widgets.
@@ -16,7 +16,7 @@
Your callback should use Gtk::FileChooser#preview_filename to see what needs previewing. Once you have generated the preview for the corresponding file, you must call Gtk::FileChooser#preview_widget_active= with a boolean flag(true or false) that indicates whether your callback could successfully generate a preview.
-==== Example 2. Sample Usage
+=== Example 2. Sample Usage
preview = Gtk::Image.new
filechooser.preview_widget = preview
@@ -31,7 +31,7 @@
=== Adding Extra Widgets
You can add extra widgets to a file chooser to provide options that are not present in the default design. For example, you can add a toggle button to give the user the option to open a file in read-only mode. You can use Gtk::FileChooser#extra_widget= to insert additional widgets in a file chooser.
-==== Example 3. Sample Usage
+=== Example 3. Sample Usage
toggle = Gtk::CheckButton.new("Open file read-only")
toggle.show
@@ -43,7 +43,7 @@
=== Key Bindings
Internally, GTK+ implements a file chooser's graphical user interface with the private GtkFileChooserDefaultClass. This widget has several key bindings and their associated signals. This section describes the available key binding signals.
-==== Example 4. Gtk::FileChooser key binding example
+=== Example 4. Gtk::FileChooser key binding example
The default keys that activate the key-binding signals in GtkFileChooserDefaultClass are as follows:
* location-popup: Control-L
@@ -81,7 +81,7 @@
:The "GtkFileChooserDefault::home-folder" signal
This is used to make the file chooser show the user's home folder in the file list. By default this is bound to Alt-Home.
-==== Example 5. Running Gtk::FileChooser example program
+=== Example 5. Running Gtk::FileChooser example program
Gtk::FileChooser module represents just an interface, hence we never create any FileChooser instances. The following list describes all FileChooser related classes: