summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorBenjamin Otte <otte@redhat.com>2022-12-23 02:42:36 +0100
committerMatthias Clasen <mclasen@redhat.com>2022-12-24 07:56:57 -0500
commit26cec4a021bc6a9e71d182f6edca2cf6002e83a4 (patch)
treecaa370ca5da410c6ae0ff4f1efcaca078e8ef01d
parent8d8e83afa2dd8ab317fc9212fd291ec1095df18b (diff)
downloadgtk+-26cec4a021bc6a9e71d182f6edca2cf6002e83a4.tar.gz
filedialog: Rename current-folder to initial-folder
It's not the current one - unlike in GtkFileChooser - because there are no live updates. So we use a more descriptive name.
-rw-r--r--demos/constraint-editor/constraint-editor-window.c4
-rw-r--r--demos/node-editor/node-editor-window.c4
-rw-r--r--gtk/gtkfiledialog.c58
-rw-r--r--gtk/gtkfiledialog.h6
4 files changed, 36 insertions, 36 deletions
diff --git a/demos/constraint-editor/constraint-editor-window.c b/demos/constraint-editor/constraint-editor-window.c
index 7b6042be25..6077ddd2f9 100644
--- a/demos/constraint-editor/constraint-editor-window.c
+++ b/demos/constraint-editor/constraint-editor-window.c
@@ -228,7 +228,7 @@ open_cb (GtkWidget *button,
dialog = gtk_file_dialog_new ();
gtk_file_dialog_set_title (dialog, "Open file");
cwd = g_file_new_for_path (".");
- gtk_file_dialog_set_current_folder (dialog, cwd);
+ gtk_file_dialog_set_initial_folder (dialog, cwd);
g_object_unref (cwd);
gtk_file_dialog_open (dialog, GTK_WINDOW (self), NULL, NULL, open_response_cb, self);
g_object_unref (dialog);
@@ -337,7 +337,7 @@ save_cb (GtkWidget *button,
dialog = gtk_file_dialog_new ();
gtk_file_dialog_set_title (dialog, "Save constraints");
cwd = g_file_new_for_path (".");
- gtk_file_dialog_set_current_folder (dialog, cwd);
+ gtk_file_dialog_set_initial_folder (dialog, cwd);
g_object_unref (cwd);
gtk_file_dialog_save (dialog,
GTK_WINDOW (gtk_widget_get_root (GTK_WIDGET (button))),
diff --git a/demos/node-editor/node-editor-window.c b/demos/node-editor/node-editor-window.c
index 89110c64be..b6dc5eb8ce 100644
--- a/demos/node-editor/node-editor-window.c
+++ b/demos/node-editor/node-editor-window.c
@@ -569,7 +569,7 @@ show_open_filechooser (NodeEditorWindow *self)
dialog = gtk_file_dialog_new ();
gtk_file_dialog_set_title (dialog, "Open node file");
cwd = g_file_new_for_path (".");
- gtk_file_dialog_set_current_folder (dialog, cwd);
+ gtk_file_dialog_set_initial_folder (dialog, cwd);
g_object_unref (cwd);
gtk_file_dialog_open (dialog, GTK_WINDOW (self),
NULL, NULL, open_response_cb, self);
@@ -633,7 +633,7 @@ save_cb (GtkWidget *button,
dialog = gtk_file_dialog_new ();
gtk_file_dialog_set_title (dialog, "Save node");
cwd = g_file_new_for_path (".");
- gtk_file_dialog_set_current_folder (dialog, cwd);
+ gtk_file_dialog_set_initial_folder (dialog, cwd);
g_object_unref (cwd);
gtk_file_dialog_save (dialog,
GTK_WINDOW (gtk_widget_get_root (GTK_WIDGET (button))),
diff --git a/gtk/gtkfiledialog.c b/gtk/gtkfiledialog.c
index cf54c8273b..bd6e3f6bdd 100644
--- a/gtk/gtkfiledialog.c
+++ b/gtk/gtkfiledialog.c
@@ -58,7 +58,7 @@ struct _GtkFileDialog
GListModel *filters;
GListModel *shortcut_folders;
GtkFileFilter *current_filter;
- GFile *current_folder;
+ GFile *initial_folder;
};
enum
@@ -68,7 +68,7 @@ enum
PROP_FILTERS,
PROP_SHORTCUT_FOLDERS,
PROP_CURRENT_FILTER,
- PROP_CURRENT_FOLDER,
+ PROP_INITIAL_FOLDER,
PROP_ACCEPT_LABEL,
NUM_PROPERTIES
@@ -94,7 +94,7 @@ gtk_file_dialog_finalize (GObject *object)
g_clear_object (&self->filters);
g_clear_object (&self->shortcut_folders);
g_clear_object (&self->current_filter);
- g_clear_object (&self->current_folder);
+ g_clear_object (&self->initial_folder);
G_OBJECT_CLASS (gtk_file_dialog_parent_class)->finalize (object);
}
@@ -129,8 +129,8 @@ gtk_file_dialog_get_property (GObject *object,
g_value_set_object (value, self->current_filter);
break;
- case PROP_CURRENT_FOLDER:
- g_value_set_object (value, self->current_folder);
+ case PROP_INITIAL_FOLDER:
+ g_value_set_object (value, self->initial_folder);
break;
case PROP_ACCEPT_LABEL:
@@ -173,8 +173,8 @@ gtk_file_dialog_set_property (GObject *object,
gtk_file_dialog_set_current_filter (self, g_value_get_object (value));
break;
- case PROP_CURRENT_FOLDER:
- gtk_file_dialog_set_current_folder (self, g_value_get_object (value));
+ case PROP_INITIAL_FOLDER:
+ gtk_file_dialog_set_initial_folder (self, g_value_get_object (value));
break;
case PROP_ACCEPT_LABEL:
@@ -258,16 +258,16 @@ gtk_file_dialog_class_init (GtkFileDialogClass *class)
G_PARAM_READWRITE|G_PARAM_STATIC_STRINGS|G_PARAM_EXPLICIT_NOTIFY);
/**
- * GtkFileDialog:current-folder: (attributes org.gtk.Property.get=gtk_file_dialog_get_current_folder org.gtk.Property.set=gtk_file_dialog_set_current_folder)
+ * GtkFileDialog:initial-folder: (attributes org.gtk.Property.get=gtk_file_dialog_get_initial_folder org.gtk.Property.set=gtk_file_dialog_set_initial_folder)
*
- * The current folder, that is, the directory that is initially
+ * The inital folder, that is, the directory that is initially
* opened in the file chooser dialog, unless overridden by parameters
* of the async call.
*
* Since: 4.10
*/
- properties[PROP_CURRENT_FOLDER] =
- g_param_spec_object ("current-folder", NULL, NULL,
+ properties[PROP_INITIAL_FOLDER] =
+ g_param_spec_object ("initial-folder", NULL, NULL,
G_TYPE_FILE,
G_PARAM_READWRITE|G_PARAM_STATIC_STRINGS|G_PARAM_EXPLICIT_NOTIFY);
@@ -573,7 +573,7 @@ gtk_file_dialog_set_current_filter (GtkFileDialog *self,
}
/**
- * gtk_file_dialog_get_current_folder:
+ * gtk_file_dialog_get_initial_folder:
* @self: a `GtkFileDialog`
*
* Gets the folder that will be set as the
@@ -584,15 +584,15 @@ gtk_file_dialog_set_current_filter (GtkFileDialog *self,
* Since: 4.10
*/
GFile *
-gtk_file_dialog_get_current_folder (GtkFileDialog *self)
+gtk_file_dialog_get_initial_folder (GtkFileDialog *self)
{
g_return_val_if_fail (GTK_IS_FILE_DIALOG (self), NULL);
- return self->current_folder;
+ return self->initial_folder;
}
/**
- * gtk_file_dialog_set_current_folder:
+ * gtk_file_dialog_set_initial_folder:
* @self: a `GtkFileDialog`
* @folder: (nullable): a `GFile`
*
@@ -604,16 +604,16 @@ gtk_file_dialog_get_current_folder (GtkFileDialog *self)
* Since: 4.10
*/
void
-gtk_file_dialog_set_current_folder (GtkFileDialog *self,
+gtk_file_dialog_set_initial_folder (GtkFileDialog *self,
GFile *folder)
{
g_return_if_fail (GTK_IS_FILE_DIALOG (self));
g_return_if_fail (folder == NULL || G_IS_FILE (folder));
- if (!g_set_object (&self->current_folder, folder))
+ if (!g_set_object (&self->initial_folder, folder))
return;
- g_object_notify_by_pspec (G_OBJECT (self), properties[PROP_CURRENT_FOLDER]);
+ g_object_notify_by_pspec (G_OBJECT (self), properties[PROP_INITIAL_FOLDER]);
}
/* }}} */
@@ -734,8 +734,8 @@ create_file_chooser (GtkFileDialog *self,
if (self->current_filter)
gtk_file_chooser_set_filter (GTK_FILE_CHOOSER (chooser), self->current_filter);
file_chooser_set_shortcut_folders (GTK_FILE_CHOOSER (chooser), self->shortcut_folders);
- if (self->current_folder)
- gtk_file_chooser_set_current_folder (GTK_FILE_CHOOSER (chooser), self->current_folder, NULL);
+ if (self->initial_folder)
+ gtk_file_chooser_set_current_folder (GTK_FILE_CHOOSER (chooser), self->initial_folder, NULL);
if (current_file)
gtk_file_chooser_set_file (GTK_FILE_CHOOSER (chooser), current_file, NULL);
else if (current_name)
@@ -793,7 +793,7 @@ finish_multiple_files_op (GtkFileDialog *self,
*
* If you pass @current_file, the file chooser will initially be
* opened in the parent directory of that file, otherwise, it
- * will be in the directory [property@Gtk.FileDialog:current-folder].
+ * will be in the directory [property@Gtk.FileDialog:initial-folder].
*
* The @callback will be called when the dialog is dismissed.
* It should call [method@Gtk.FileDialog.open_finish]
@@ -860,7 +860,7 @@ gtk_file_dialog_open_finish (GtkFileDialog *self,
* gtk_file_dialog_select_folder:
* @self: a `GtkFileDialog`
* @parent: (nullable): the parent `GtkWindow`
- * @current_folder: (nullable): the folder to select initially
+ * @initial_folder: (nullable): the folder to select initially
* @cancellable: (nullable): a `GCancellable` to cancel the operation
* @callback: (scope async): a callback to call when the operation is complete
* @user_data: (closure callback): data to pass to @callback
@@ -868,9 +868,9 @@ gtk_file_dialog_open_finish (GtkFileDialog *self,
* This function initiates a directory selection operation by
* presenting a file chooser dialog to the user.
*
- * If you pass @current_folder, the file chooser will initially be
+ * If you pass @initial_folder, the file chooser will initially be
* opened in the parent directory of that folder, otherwise, it
- * will be in the directory [property@Gtk.FileDialog:current-folder].
+ * will be in the directory [property@Gtk.FileDialog:initial-folder].
*
* The @callback will be called when the dialog is dismissed.
* It should call [method@Gtk.FileDialog.select_folder_finish]
@@ -881,7 +881,7 @@ gtk_file_dialog_open_finish (GtkFileDialog *self,
void
gtk_file_dialog_select_folder (GtkFileDialog *self,
GtkWindow *parent,
- GFile *current_folder,
+ GFile *initial_folder,
GCancellable *cancellable,
GAsyncReadyCallback callback,
gpointer user_data)
@@ -892,7 +892,7 @@ gtk_file_dialog_select_folder (GtkFileDialog *self,
g_return_if_fail (GTK_IS_FILE_DIALOG (self));
chooser = create_file_chooser (self, parent, GTK_FILE_CHOOSER_ACTION_SELECT_FOLDER,
- current_folder, NULL, FALSE);
+ initial_folder, NULL, FALSE);
task = g_task_new (self, cancellable, callback, user_data);
g_task_set_check_cancellable (task, FALSE);
@@ -951,7 +951,7 @@ gtk_file_dialog_select_folder_finish (GtkFileDialog *self,
*
* If you pass @current_file, the file chooser will initially be
* opened in the parent directory of that file, otherwise, it
- * will be in the directory [property@Gtk.FileDialog:current-folder].
+ * will be in the directory [property@Gtk.FileDialog:initial-folder].
*
* The @callback will be called when the dialog is dismissed.
* It should call [method@Gtk.FileDialog.save_finish]
@@ -1027,7 +1027,7 @@ gtk_file_dialog_save_finish (GtkFileDialog *self,
* presenting a file chooser dialog to the user.
*
* The file chooser will initially be opened in the directory
- * [property@Gtk.FileDialog:current-folder].
+ * [property@Gtk.FileDialog:initial-folder].
*
* The @callback will be called when the dialog is dismissed.
* It should call [method@Gtk.FileDialog.open_multiple_finish]
@@ -1102,7 +1102,7 @@ gtk_file_dialog_open_multiple_finish (GtkFileDialog *self,
* presenting a file chooser dialog to the user.
*
* The file chooser will initially be opened in the directory
- * [property@Gtk.FileDialog:current-folder].
+ * [property@Gtk.FileDialog:initial-folder].
*
* The @callback will be called when the dialog is dismissed.
* It should call [method@Gtk.FileDialog.select_multiple_folders_finish]
diff --git a/gtk/gtkfiledialog.h b/gtk/gtkfiledialog.h
index 5c3cac52bc..69123baacc 100644
--- a/gtk/gtkfiledialog.h
+++ b/gtk/gtkfiledialog.h
@@ -74,10 +74,10 @@ void gtk_file_dialog_set_shortcut_folders
GListModel *shortcut_folders);
GDK_AVAILABLE_IN_4_10
-GFile * gtk_file_dialog_get_current_folder (GtkFileDialog *self);
+GFile * gtk_file_dialog_get_initial_folder (GtkFileDialog *self);
GDK_AVAILABLE_IN_4_10
-void gtk_file_dialog_set_current_folder (GtkFileDialog *self,
+void gtk_file_dialog_set_initial_folder (GtkFileDialog *self,
GFile *folder);
GDK_AVAILABLE_IN_4_10
@@ -96,7 +96,7 @@ GFile * gtk_file_dialog_open_finish (GtkFileDialog *self
GDK_AVAILABLE_IN_4_10
void gtk_file_dialog_select_folder (GtkFileDialog *self,
GtkWindow *parent,
- GFile *current_folder,
+ GFile *initial_folder,
GCancellable *cancellable,
GAsyncReadyCallback callback,
gpointer user_data);