AuroraMiddleware/gtk
1
0
Fork 1
mirror of https://gitlab.gnome.org/GNOME/gtk.git synced 2025-01-13 14:00:09 +00:00
Code Issues Projects Releases Wiki Activity

Added a section explaining character encoding for filenames.

Browse Source 
2004-04-15  Federico Mena Quintero  <federico@ximian.com>

	* gtk/tmpl/gtkfilechooser.sgml: Added a section explaining
	character encoding for filenames.
This commit is contained in:
Federico Mena Quintero 2004-04-16 00:45:21 +00:00 committed by Federico Mena Quintero
parent a1632f174c
commit df84bd5f57
2 changed files with 34 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

5
docs/reference/ChangeLog
View File

@ -1,3 +1,8 @@
2004-04-15 Federico Mena Quintero <federico@ximian.com>
* gtk/tmpl/gtkfilechooser.sgml: Added a section explaining
character encoding for filenames.
2004-04-13 Matthias Clasen <mclasen@redhat.com>
* gtk/tmpl/gtkuimanager.sgml: Some corrections.

29
docs/reference/gtk/tmpl/gtkfilechooser.sgml
View File

@ -15,6 +15,35 @@ File chooser interface used by #GtkFileChooserWidget and #GtkFileChooserDialog.
programming interface.
</para>
<refsect2 id="gtkfilechooser-encodings">
<title>File Names and Encodings</title>
<para>
When the user is finished selecting files in a
#GtkFileChooser, 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 <emphasis>always</emphasis> returned in
the character set specified by the
<envar>G_FILENAME_ENCODING</envar> environment variable.
Please see the Glib documentation for more details about this
variable.
</para>
<important>
<para>
This means that while you can pass the result of
gtk_file_chooser_get_filename() to
<function>open(2)</function> or
<function>fopen(3)</function>, you may not be able to
directly set it as the text of a #GtkLabel widget unless you
convert it first to UTF-8, which all GTK+ widgets expect.
You should use g_filename_to_utf8() to convert filenames
into strings that can be passed to GTK+ widgets.
</para>
</important>
</refsect2>
<refsect2 id="gtkfilechooser-preview">
<title>Adding a Preview Widget</title>