类

GtkFileChooserDialog

已弃用：4.10

说明 [源代码]

final class Gtk.FileChooserDialog : Gtk.Dialog
  implements Gtk.Accessible, Gtk.Buildable, Gtk.ConstraintTarget, Gtk.FileChooser, Gtk.Native, Gtk.Root, Gtk.ShortcutManager {
  /* No available fields */
}

GtkFileChooserDialog 是一个适合与“文件打开”或“文件保存”命令配合使用的对话框。

An example GtkFileChooserDialog

此小工具通过将 GtkFileChooserWidget 放在 GtkDialog 中进行工作。它公开 GtkFileChooser 接口，因此您可以在文件选择器对话框以及 GtkDialog 的文件选择器函数上使用所有 GtkFileChooser 函数。

请注意，GtkFileChooserDialog 没有任何自己的方法。相反，您应该使用对 GtkFileChooser 起作用的函数。

如果您希望与平台很好地集成，则应使用 GtkFileChooserNative API，它将在可用时使用特定于平台的对话框，否则回退到 GtkFileChooserDialog。

典型用法

在最简单的情况下，可以使用以下代码来使用 GtkFileChooserDialog 选择要打开的文件

static void
on_open_response (GtkDialog *dialog,
                  int        response)
{
  if (response == GTK_RESPONSE_ACCEPT)
    {
      GtkFileChooser *chooser = GTK_FILE_CHOOSER (dialog);

      g_autoptr(GFile) file = gtk_file_chooser_get_file (chooser);

      open_file (file);
    }

  gtk_window_destroy (GTK_WINDOW (dialog));
}

  // ...
  GtkWidget *dialog;
  GtkFileChooserAction action = GTK_FILE_CHOOSER_ACTION_OPEN;

  dialog = gtk_file_chooser_dialog_new ("Open File",
                                        parent_window,
                                        action,
                                        _("_Cancel"),
                                        GTK_RESPONSE_CANCEL,
                                        _("_Open"),
                                        GTK_RESPONSE_ACCEPT,
                                        NULL);

  gtk_window_present (GTK_WINDOW (dialog));

  g_signal_connect (dialog, "response",
                    G_CALLBACK (on_open_response),
                    NULL);

要将对话框用于保存，可以使用

static void
on_save_response (GtkDialog *dialog,
                  int        response)
{
  if (response == GTK_RESPONSE_ACCEPT)
    {
      GtkFileChooser *chooser = GTK_FILE_CHOOSER (dialog);

      g_autoptr(GFile) file = gtk_file_chooser_get_file (chooser);

      save_to_file (file);
    }

  gtk_window_destroy (GTK_WINDOW (dialog));
}

  // ...
  GtkWidget *dialog;
  GtkFileChooser *chooser;
  GtkFileChooserAction action = GTK_FILE_CHOOSER_ACTION_SAVE;

  dialog = gtk_file_chooser_dialog_new ("Save File",
                                        parent_window,
                                        action,
                                        _("_Cancel"),
                                        GTK_RESPONSE_CANCEL,
                                        _("_Save"),
                                        GTK_RESPONSE_ACCEPT,
                                        NULL);
  chooser = GTK_FILE_CHOOSER (dialog);

  if (user_edited_a_new_document)
    gtk_file_chooser_set_current_name (chooser, _("Untitled document"));
  else
    gtk_file_chooser_set_file (chooser, existing_filename);

  gtk_window_present (GTK_WINDOW (dialog));

  g_signal_connect (dialog, "response",
                    G_CALLBACK (on_save_response),
                    NULL);

设置文件选择器对话框

在各种情况下，您可能需要使用 GtkFileChooserDialog

要选择要打开的文件，请使用 GTK_FILE_CHOOSER_ACTION_OPEN。
要首次保存文件，请使用 GTK_FILE_CHOOSER_ACTION_SAVE，并建议使用 gtk_file_chooser_set_current_name() 的“未命名”之类的名称。
要以不同的名称保存文件，请使用 GTK_FILE_CHOOSER_ACTION_SAVE，并使用 gtk_file_chooser_set_file() 设置现有文件。
要选择文件夹而不是文件，请使用 GTK_FILE_CHOOSER_ACTION_SELECT_FOLDER。

一般而言，只有在适合使用 gtk_file_chooser_set_file() 才能让文件选择器显示特定文件夹，即当您执行“另存为”命令并且已经将文件保存在某处时。

响应码

GtkFileChooserDialog 从 GtkDialog 继承，因此其操作区域中的按钮具有诸如 GTK_RESPONSE_ACCEPT 和 GTK_RESPONSE_CANCEL 的响应码。例如，您可以按如下方式调用 gtk_file_chooser_dialog_new()

GtkWidget *dialog;
GtkFileChooserAction action = GTK_FILE_CHOOSER_ACTION_OPEN;

dialog = gtk_file_chooser_dialog_new ("Open File",
                                      parent_window,
                                      action,
                                      _("_Cancel"),
                                      GTK_RESPONSE_CANCEL,
                                      _("_Open"),
                                      GTK_RESPONSE_ACCEPT,
                                      NULL);

这将为“取消”和“打开”创建按钮，它们使用 GtkResponseType 中预定义的响应标识符。对于大多数对话框，您可以使用您自己的自定义响应码，而不是 GtkResponseType 中的响应码，但 GtkFileChooserDialog 假设其“接受”类型的操作（例如“打开”或“保存”按钮）具有以下响应码之一

GTK_RESPONSE_ACCEPT
GTK_RESPONSE_OK
GTK_RESPONSE_YES
GTK_RESPONSE_APPLY

这是因为 GtkFileChooserDialog 必须拦截响应并在适当的时候切换到文件夹，而不是让对话框终止 - 实现使用这些已知响应码来知道在适当的时候可以阻止哪些响应

总结是，当您使用 GtkFileChooserDialog 来确保适当操作时，请务必使用预定义的响应码。

CSS 节点

GtkFileChooserDialog 具有一个名为 window 且样式类为 .filechooser 的 CSS 节点。

已弃用：4.10

改为使用 GtkFileDialog 。

层级关系

祖先

实现

构造函数

gtk_file_chooser_dialog_new

创建新的 GtkFileChooserDialog。

已弃用：4.10

实例方法

从 GtkWindow 继承的方法 (55)

敬请参阅 GtkWindow 来获取完整的方法列表。

从 GtkWidget 继承的方法 (162)

敬请参阅 GtkWidget 来获取完整的方法列表。

从 GObject 继承的方法 (43)

敬请参阅 GObject 来获取完整的方法列表。

从 GtkBuildable (1) 继承的方法

gtk_buildable_get_buildable_id

获取 buildable 对象的 ID。

从 GtkFileChooser (25) 继承的方法

请参阅 GtkFileChooser 以获取完整的方法列表。

属性

从 GtkDialog (1) 继承的属性

Gtk.Dialog:use-header-bar

如果对话框使用信息标头栏代替操作区域来放置操作按钮，则为 TRUE。

已弃用：4.10

从 GtkAccessible 继承的属性 (1)

GtkAccessible:accessible-role

给定 GtkAccessible 实现的可访问的角色。

信号

从 GtkDialog 继承的信号 (2)

GtkDialog::close

当用户使用键盘绑定关闭对话框时发出。

已弃用：4.10

GtkDialog::response

当操作部件被单击时发出。

已弃用：4.10

从 GObject 继承的信号 (1)

GObject::notify

当对象的一个属性通过 g_object_set_property()、g_object_set()、或其它方法设置其值时，notify 信号就针对该对象发出。

说明 [源代码]

典型用法

设置文件选择器对话框

响应码

CSS 节点

层级关系

祖先

实现

构造函数

实例方法

从 GtkDialog 继承的方法 (10)

从 GtkWindow 继承的方法 (55)

从 GtkWidget 继承的方法 (162)

从 GObject 继承的方法 (43)

从 GtkAccessible 继承的方法 (19)

从 GtkBuildable (1) 继承的方法

从 GtkFileChooser (25) 继承的方法

从 GtkNative (5) 继承的方法

从 GtkRoot (3) 继承的方法

属性

从 GtkDialog (1) 继承的属性

从 GtkWindow (25) 继承的属性

从 GtkWidget 继承的属性 (34)

从 GtkAccessible 继承的属性 (1)

从 GtkFileChooser 继承的属性 (6)

信号

从 GtkDialog 继承的信号 (2)

从 GtkWindow 继承的信号 (5)

从 GtkWidget 继承的信号 (13)