方法

GtkFileChooserset_file

已弃用：4.10

声明 [src]

gboolean
gtk_file_chooser_set_file (
  GtkFileChooser* chooser,
  GFile* file,
  GError** error
)

描述 [src]

将 file 设置为文件选择器的当前文件名。

这包括改变到文件的父文件夹并真正在列表中选择该文件。如果 chooser 在 GTK_FILE_CHOOSER_ACTION_SAVE 模式下，文件的基名也将出现在对话框的文件名输入框中。

如果文件名不在 chooser 的当前文件夹中，则 chooser 的当前文件夹将更改为包含文件的文件夹。

请注意，文件必须存在，否则除更改目录外不会执行任何操作。

如果您正在实现一个保存对话框，并且已经有用户可以保存的文件名，则应使用此函数；例如，当用户打开现有文件然后进行“另存为…”操作时。如果您没有文件名 — 例如，如果用户刚刚创建了一个新文件并且是第一次保存，则不要调用此函数。

相反，可以使用类似以下的内容

static void
prepare_file_chooser (GtkFileChooser *chooser,
                      GFile          *existing_file)
{
  gboolean document_is_new = (existing_file == NULL);

  if (document_is_new)
    {
      GFile *default_file_for_saving = g_file_new_for_path ("./out.txt");
      // the user just created a new document
      gtk_file_chooser_set_current_folder (chooser, default_file_for_saving, NULL);
      gtk_file_chooser_set_current_name (chooser, "Untitled document");
      g_object_unref (default_file_for_saving);
    }
  else
    {
      // the user edited an existing document
      gtk_file_chooser_set_file (chooser, existing_file, NULL);
    }
}

已弃用自：4.10

请使用 GtkFileDialog 代替。

参数

file

类型： GFile

要设置的当前 GFile。

数据由方法的调用者拥有。

error

类型: GError **

恢复错误返回的位置。

参数可以是NULL。

如果返回位置不是NULL，则您必须将其初始化为NULL的GError*。

如果没有错误，方法将保留参数为NULL初始化。

在发生错误的情况下，参数将被设置为一个新的GError分配；调用者将拥有数据，并负责释放它。

返回值

类型: gboolean

无意义。