356df7f650
Thu Oct 23 21:55:10 2003 Soeren Sandmann <sandmann@daimi.au.dk> * gtk/gtktoolbar.c (gtk_toolbar_highlight_drop_location): Make this function take an index and a GtkToolItem. * tests/testtoolbar.c (main): Make "Show Arrow" default to true. Make one of the separators !draw and expand. Update for new highlight_drop_location() API. * gtk/gtktoolitem.[ch]: Remove "pack_end" property * gtk/gtktoolbar.h: Formatting fixes. * gtk/gtktoolbar.c: Remove "pack_end" child property. Allow separator tool items to expand. (logical_to_physical, physical_to_logical): Fix off-by-one errors (Fix #125472, Marco Pesenti Gritti) * gtk/gtkseparatortoolitem.[ch]: Add new "draw" property. (gtk_separator_tool_item_expose) only draw if "draw" is TRUE. Also return FALSE, not TRUE. (gtk_separator_too_item_{set|get}_property, (gtk_separator_tool_item_{set|get}_draw): new functions
498 lines
6.9 KiB
Plaintext
498 lines
6.9 KiB
Plaintext
<!-- ##### SECTION Title ##### -->
|
|
GtkFileChooser
|
|
|
|
<!-- ##### SECTION Short_Description ##### -->
|
|
File chooser interface used by #GtkFileChooserWidget and #GtkFileChooserDialog.
|
|
|
|
<!-- ##### SECTION Long_Description ##### -->
|
|
<para>
|
|
#GtkFileChooser is an interface that can be implemented by file
|
|
selection widgets. In GTK+, the main objects that implement
|
|
this interface are #GtkFileChooserWidget and
|
|
#GtkFileChooserDialog. You do not need to write an object that
|
|
implements the #GtkFileChooser interface unless you are trying
|
|
to adapt an existing file selector to expose a standard
|
|
programming interface.
|
|
</para>
|
|
|
|
<!-- ##### SECTION See_Also ##### -->
|
|
<para>
|
|
#GtkFileChooserDialog, #GtkFileChooserWidget
|
|
</para>
|
|
|
|
<!-- ##### ENUM GtkFileChooserAction ##### -->
|
|
<para>
|
|
Describes whether a #GtkFileChooser is being used to open
|
|
existing files or to save to a possibly new file.
|
|
</para>
|
|
|
|
@GTK_FILE_CHOOSER_ACTION_OPEN: Indicates Open mode. The file chooser
|
|
will only let the user pick an existing file.
|
|
@GTK_FILE_CHOOSER_ACTION_SAVE: Indicates Save mode. The file chooser
|
|
will let the user pick an existing file, or type in a new
|
|
filename.
|
|
|
|
<!-- ##### MACRO GTK_FILE_CHOOSER_ERROR ##### -->
|
|
<para>
|
|
Used to get the #GError quark for #GtkFileChooser errors.
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### ENUM GtkFileChooserError ##### -->
|
|
<para>
|
|
These identify the various errors that can occur while calling
|
|
#GtkFileChooser functions.
|
|
</para>
|
|
|
|
@GTK_FILE_CHOOSER_ERROR_NONEXISTENT: Indicates that a file does not exist.
|
|
@GTK_FILE_CHOOSER_ERROR_BAD_FILENAME: Indicates a malformed filename.
|
|
|
|
<!-- ##### FUNCTION gtk_file_chooser_error_quark ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_file_chooser_set_action ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@chooser:
|
|
@action:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_file_chooser_get_action ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@chooser:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_file_chooser_set_folder_mode ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@chooser:
|
|
@folder_mode:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_file_chooser_get_folder_mode ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@chooser:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_file_chooser_set_local_only ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@chooser:
|
|
@files_only:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_file_chooser_get_local_only ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@chooser:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_file_chooser_set_select_multiple ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@chooser:
|
|
@select_multiple:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_file_chooser_get_select_multiple ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@chooser:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_file_chooser_set_current_name ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@chooser:
|
|
@name:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_file_chooser_get_filename ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@chooser:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_file_chooser_set_filename ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@chooser:
|
|
@filename:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_file_chooser_select_filename ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@chooser:
|
|
@filename:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_file_chooser_unselect_filename ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@chooser:
|
|
@filename:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_file_chooser_select_all ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@chooser:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_file_chooser_unselect_all ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@chooser:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_file_chooser_get_filenames ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@chooser:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_file_chooser_set_current_folder ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@chooser:
|
|
@filename:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_file_chooser_get_current_folder ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@chooser:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_file_chooser_get_uri ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@chooser:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_file_chooser_set_uri ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@chooser:
|
|
@uri:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_file_chooser_select_uri ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@chooser:
|
|
@uri:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_file_chooser_unselect_uri ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@chooser:
|
|
@uri:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_file_chooser_get_uris ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@chooser:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_file_chooser_set_current_folder_uri ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@chooser:
|
|
@uri:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_file_chooser_get_current_folder_uri ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@chooser:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_file_chooser_set_preview_widget ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@chooser:
|
|
@preview_widget:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_file_chooser_get_preview_widget ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@chooser:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_file_chooser_set_preview_widget_active ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@chooser:
|
|
@active:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_file_chooser_get_preview_widget_active ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@chooser:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_file_chooser_get_preview_filename ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@file_chooser:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_file_chooser_get_preview_uri ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@file_chooser:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_file_chooser_set_extra_widget ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@chooser:
|
|
@extra_widget:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_file_chooser_get_extra_widget ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@chooser:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_file_chooser_add_filter ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@chooser:
|
|
@filter:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_file_chooser_remove_filter ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@chooser:
|
|
@filter:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_file_chooser_list_filters ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@chooser:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_file_chooser_set_filter ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@chooser:
|
|
@filter:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_file_chooser_get_filter ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@chooser:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_file_chooser_add_shortcut_folder ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@chooser:
|
|
@folder:
|
|
@error:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_file_chooser_remove_shortcut_folder ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@chooser:
|
|
@folder:
|
|
@error:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_file_chooser_list_shortcut_folders ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@chooser:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_file_chooser_add_shortcut_folder_uri ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@chooser:
|
|
@folder:
|
|
@error:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_file_chooser_remove_shortcut_folder_uri ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@chooser:
|
|
@folder:
|
|
@error:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_file_chooser_list_shortcut_folder_uris ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@chooser:
|
|
@Returns:
|
|
|
|
|
|
|
|
<!--
|
|
Local variables:
|
|
mode: sgml
|
|
sgml-parent-document: ("../gtk-docs.sgml" "book" "refentry")
|
|
End:
|
|
-->
|
|
|
|
|
|
<!-- ##### SIGNAL GtkFileChooser::current-folder-changed ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@filechooser: the object which received the signal.
|
|
|
|
<!-- ##### SIGNAL GtkFileChooser::file-activated ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@filechooser: the object which received the signal.
|
|
|
|
<!-- ##### SIGNAL GtkFileChooser::selection-changed ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@filechooser: the object which received the signal.
|
|
|
|
<!-- ##### SIGNAL GtkFileChooser::update-preview ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@filechooser: the object which received the signal.
|
|
|