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

1
2
3
4
5
6
7
8

{
  CtkWidget *button;

  button = ctk_file_chooser_button_new (_("Select a file"),
                                        CTK_FILE_CHOOSER_ACTION_OPEN);
  ctk_file_chooser_set_current_folder (CTK_FILE_CHOOSER (button),
                                       "/etc");
}

The CtkFileChooserButton supports the CtkFileChooserActions CTK_FILE_CHOOSER_ACTION_OPEN and CTK_FILE_CHOOSER_ACTION_SELECT_FOLDER.

CSS nodes

CtkFileChooserButton has a CSS node with name “filechooserbutton”, containing a subnode for the internal button with name “button” and style class “.file”.

ctk_file_chooser_button_new ()

CtkWidget *
ctk_file_chooser_button_new (const gchar *title,
                             CtkFileChooserAction action);

Creates a new file-selecting button widget.

Since: 2.6

ctk_file_chooser_button_new_with_dialog ()

CtkWidget *
ctk_file_chooser_button_new_with_dialog
                               (CtkWidget *dialog);

Creates a CtkFileChooserButton widget which uses dialog as its file-picking window.

Note that dialog must be a CtkDialog (or subclass) which implements the CtkFileChooser interface and must not have CTK_DIALOG_DESTROY_WITH_PARENT set.

Also note that the dialog needs to have its confirmative button added with response CTK_RESPONSE_ACCEPT or CTK_RESPONSE_OK in order for the button to take over the file selected in the dialog.

Since: 2.6

ctk_file_chooser_button_get_title ()

const gchar *
ctk_file_chooser_button_get_title (CtkFileChooserButton *button);

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

Since: 2.6

ctk_file_chooser_button_set_title ()

void
ctk_file_chooser_button_set_title (CtkFileChooserButton *button,
                                   const gchar *title);

Modifies the title of the browse dialog used by button .

Since: 2.6

ctk_file_chooser_button_get_width_chars ()

gint
ctk_file_chooser_button_get_width_chars
                               (CtkFileChooserButton *button);

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

Since: 2.6

ctk_file_chooser_button_set_width_chars ()

void
ctk_file_chooser_button_set_width_chars
                               (CtkFileChooserButton *button,
                                gint n_chars);

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

Since: 2.6

ctk_file_chooser_button_get_focus_on_click ()

gboolean
ctk_file_chooser_button_get_focus_on_click
                               (CtkFileChooserButton *button);

Returns whether the button grabs focus when it is clicked with the mouse. See ctk_file_chooser_button_set_focus_on_click().

Since: 2.10

ctk_file_chooser_button_set_focus_on_click ()

void
ctk_file_chooser_button_set_focus_on_click
                               (CtkFileChooserButton *button,
                                gboolean focus_on_click);

Sets whether the button will grab focus when it is clicked with the mouse. Making mouse clicks not grab focus is useful in places like toolbars where you don’t want the keyboard focus removed from the main area of the application.

Since: 2.10

struct CtkFileChooserButton

struct CtkFileChooserButton;

struct CtkFileChooserButtonClass

struct CtkFileChooserButtonClass {
  CtkBoxClass parent_class;

  void (* file_set) (CtkFileChooserButton *fc);
};

The “dialog” property

  “dialog”                   CtkFileChooser *

Instance of the CtkFileChooserDialog associated with the button.

Owner: CtkFileChooserButton

Flags: Write / Construct Only

Since: 2.6

The “title” property

  “title”                    char *

Title to put on the CtkFileChooserDialog associated with the button.

Owner: CtkFileChooserButton

Flags: Read / Write

Default value: "Select a File"

Since: 2.6

The “width-chars” property

  “width-chars”              int

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

Owner: CtkFileChooserButton

Flags: Read / Write

Allowed values: >= -1

Default value: -1

Since: 2.6

The “file-set” signal

void
user_function (CtkFileChooserButton *widget,
               gpointer              user_data)

The ::file-set signal is emitted when the user selects a file.

Note that this signal is only emitted when the user changes the file.

Flags: Run First

Since: 2.12