1b45c64014
2004-11-30 James M. Cape <jcape@ignore-your.tv> * gtk/gtkfilechooserbutton.h (gtk_file_chooser_button_get_active) (gtk_file_chooser_button_set_active): * gtk/gtkfilechooserbutton.c (gtk_file_chooser_button_class_init) (gtk_file_chooser_button_get_active) (gtk_file_chooser_button_set_active): * docs/reference/gtk/gtk-sections.txt: * docs/reference/gtk/tmpl/gtkfilechooserbutton.sgml: * gtk/gtk.symbols: removed "GtkFileChooserButton:active" property and getter/setter. * gtk/gtkfilechooserbutton.c (struct _GtkFileChooserButtonPrivate) (button_toggled_cb) (dialog_response_cb) (button_notify_active_cb) (gtk_file_chooser_button_init) (button_clicked_cb) (gtk_file_chooser_button_show): Use a GtkButton instead of a GtkToggleButton. (struct _GtkFileChooserButtonPrivate) (gtk_file_chooser_button_destroy) (gtk_file_chooser_button_style_set) (gtk_file_chooser_button_screen_changed): Don't bother with the (remove_settings_signal) (settings_notify_cb) (check_icon_theme): Don't use GtkSettings at all, just call change_icon_theme() directly. (struct _GtkFileChooserButtonPrivate) (gtk_file_chooser_button_init) (gtk_file_chooser_button_drag_data_received) (gtk_file_chooser_button_mnemonic_activate) (gtk_file_chooser_button_set_width_chars) (gtk_file_chooser_button_get_width_chars) (entry_changed_cb) (update_idler) (update_entry) (update_dialog) (dialog_selection_changed_cb) (dialog_response_cb) (entry_size_allocate_cb): Remove all references to the now-defunct entry, store the old path (to support "Cancel") in an instance member. (update_label_and_image) (update_label) (update_image) (gtk_file_chooser_button_init) (dialog_response_cb) (dialog_selection_changed_cb): Merge label/image updates, only display the filename (not the whole path, fixes #157725). (struct _GtkFileChooserButtonPrivate) (dialog_selection_changed_cb) (dialog_selection_changed_proxy_cb): Merge "selection-changed" handlers, block while dialog is visible (fixes #158482). * tests/testfilechooserbutton.c (delete_event_cb) (properties_button_clicked_cb) (print_selected_path_clicked_cb) (tests_button_clicked_cb) (main): Add per-chooser "tests" window, don't delete on WM close, update properties_button_clicked_cb() "delete-event" callback.
135 lines
2.5 KiB
Plaintext
135 lines
2.5 KiB
Plaintext
<!-- ##### SECTION Title ##### -->
|
|
GtkFileChooserButton
|
|
|
|
<!-- ##### SECTION Short_Description ##### -->
|
|
A button to launch a file selection dialog
|
|
|
|
<!-- ##### SECTION Long_Description ##### -->
|
|
<para>
|
|
The #GtkFileChooserButton is a widget that lets the user select a
|
|
file. It implements the #GtkFileChooser interface. Visually, it is a
|
|
file name with a button to bring up a #GtkFileChooserDialog.
|
|
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.
|
|
</para>
|
|
|
|
<example>
|
|
<title>Create a button to let the user select a file in /etc</title>
|
|
<programlisting>
|
|
{
|
|
GtkWidget *button;
|
|
|
|
button = gtk_file_chooser_button_new (_("Select a file"));
|
|
gtk_file_chooser_set_current_folder (GTK_FILE_CHOOSER (button),
|
|
"/etc");
|
|
}
|
|
</programlisting>
|
|
</example>
|
|
|
|
<para>
|
|
The #GtkFileChooserButton supports the #GtkFileChooserAction<!--
|
|
-->s %GTK_FILE_CHOOSER_ACTION_OPEN and %GTK_FILE_CHOOSER_ACTION_SELECT_FOLDER.
|
|
</para>
|
|
|
|
<important>
|
|
<para>
|
|
The #GtkFileChooserButton will ellipsize the label,
|
|
and thus will thus request little horizontal space. To give the button
|
|
more space, you should call gtk_widget_size_request(),
|
|
gtk_file_chooser_button_set_width_chars(), or pack the button in
|
|
such a way that other interface elements give space to the widget.
|
|
</para>
|
|
</important>
|
|
|
|
<!-- ##### SECTION See_Also ##### -->
|
|
<para>
|
|
#GtkFileChooserDialog
|
|
</para>
|
|
|
|
<!-- ##### STRUCT GtkFileChooserButton ##### -->
|
|
<para>
|
|
This should not be accessed directly. Use the accessor functions below.
|
|
</para>
|
|
|
|
|
|
<!-- ##### ARG GtkFileChooserButton:dialog ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
<!-- ##### ARG GtkFileChooserButton:title ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
<!-- ##### ARG GtkFileChooserButton:width-chars ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
<!-- ##### FUNCTION gtk_file_chooser_button_new ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@title:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_file_chooser_button_new_with_backend ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@title:
|
|
@backend:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_file_chooser_button_new_with_dialog ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@dialog:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_file_chooser_button_get_title ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@button:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_file_chooser_button_set_title ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@button:
|
|
@title:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_file_chooser_button_get_width_chars ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@button:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_file_chooser_button_set_width_chars ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@button:
|
|
@n_chars:
|
|
|
|
|