<< Back to man.ChinaUnix.net

<< Back to man.ChinaUnix.net

GtkFileChooserButton

GtkFileChooserButton — A button to launch a file selection dialog

Synopsis


#include <gtk/gtk.h>


            GtkFileChooserButton;
GtkWidget*  gtk_file_chooser_button_new     (const gchar *title,
                                             GtkFileChooserAction action);
GtkWidget*  gtk_file_chooser_button_new_with_backend
                                            (const gchar *title,
                                             GtkFileChooserAction action,
                                             const gchar *backend);
GtkWidget*  gtk_file_chooser_button_new_with_dialog
                                            (GtkWidget *dialog);
const gchar* gtk_file_chooser_button_get_title
                                            (GtkFileChooserButton *button);
void        gtk_file_chooser_button_set_title
                                            (GtkFileChooserButton *button,
                                             const gchar *title);
gint        gtk_file_chooser_button_get_width_chars
                                            (GtkFileChooserButton *button);
void        gtk_file_chooser_button_set_width_chars
                                            (GtkFileChooserButton *button,
                                             gint n_chars);


Object Hierarchy


  GObject
   +----GtkObject
         +----GtkWidget
               +----GtkContainer
                     +----GtkBox
                           +----GtkHBox
                                 +----GtkFileChooserButton

Implemented Interfaces

GtkFileChooserButton implements AtkImplementorIface and GtkFileChooser.

Properties


  "dialog"               GtkFileChooserDialog  : Write / Construct Only
  "title"                gchararray            : Read / Write
  "width-chars"          gint                  : Read / Write

Description

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.

Example 5. Create a button to let the user select a file in /etc

{
  GtkWidget *button;

  button = gtk_file_chooser_button_new (_("Select a file"),
                                        GTK_FILE_CHOOSER_ACTION_OPEN);
  gtk_file_chooser_set_current_folder (GTK_FILE_CHOOSER (button),
                                       "/etc");
}

The GtkFileChooserButton supports the GtkFileChooserActions GTK_FILE_CHOOSER_ACTION_OPEN and GTK_FILE_CHOOSER_ACTION_SELECT_FOLDER.

Important

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.

Details

GtkFileChooserButton

typedef struct _GtkFileChooserButton GtkFileChooserButton;

This should not be accessed directly. Use the accessor functions below.


gtk_file_chooser_button_new ()

GtkWidget*  gtk_file_chooser_button_new     (const gchar *title,
                                             GtkFileChooserAction action);

Creates a new file-selecting button widget.

title : the title of the browse dialog.
action : the open mode for the widget.
Returns : a new button widget.

Since 2.6


gtk_file_chooser_button_new_with_backend ()

GtkWidget*  gtk_file_chooser_button_new_with_backend
                                            (const gchar *title,
                                             GtkFileChooserAction action,
                                             const gchar *backend);

Creates a new file-selecting button widget using backend.

title : the title of the browse dialog.
action : the open mode for the widget.
backend : the name of the GtkFileSystem backend to use.
Returns : a new button widget.

Since 2.6


gtk_file_chooser_button_new_with_dialog ()

GtkWidget*  gtk_file_chooser_button_new_with_dialog
                                            (GtkWidget *dialog);

Creates a GtkFileChooserButton widget which uses dialog as it's file-picking window. Note that dialog must be a GtkFileChooserDialog (or subclass).

dialog : the GtkFileChooserDialog widget to use.
Returns : a new button widget.

Since 2.6


gtk_file_chooser_button_get_title ()

const gchar* gtk_file_chooser_button_get_title
                                            (GtkFileChooserButton *button);

Retrieves the title of the browse dialog used by button. The returned value should not be modified or freed.

button : the button widget to examine.
Returns : a pointer to the browse dialog's title.

Since 2.6


gtk_file_chooser_button_set_title ()

void        gtk_file_chooser_button_set_title
                                            (GtkFileChooserButton *button,
                                             const gchar *title);

Modifies the title of the browse dialog used by button.

button : the button widget to modify.
title : the new browse dialog title.

Since 2.6


gtk_file_chooser_button_get_width_chars ()

gint        gtk_file_chooser_button_get_width_chars
                                            (GtkFileChooserButton *button);

Retrieves the width in characters of the button widget's entry and/or label.

button : the button widget to examine.
Returns : an integer width (in characters) that the button will use to size itself.

Since 2.6


gtk_file_chooser_button_set_width_chars ()

void        gtk_file_chooser_button_set_width_chars
                                            (GtkFileChooserButton *button,
                                             gint n_chars);

Sets the width (in characters) that button will use to n_chars.

button : the button widget to examine.
n_chars : the new width, in characters.

Since 2.6

Properties

The "dialog" property

  "dialog"               GtkFileChooserDialog  : Write / Construct Only

Instance of the GtkFileChooserDialog associated with the button.

Since 2.6


The "title" property

  "title"                gchararray            : Read / Write

Title to put on the GtkFileChooserDialog associated with the button.

Default value: "Select A File"

Since 2.6


The "width-chars" property

  "width-chars"          gint                  : Read / Write

The width of the entry and label inside the button, in characters.

Allowed values: >= -1

Default value: -1

Since 2.6

See Also

GtkFileChooserDialog