From fc586da5a8576436d4e859ecb7802b635b533df6 Mon Sep 17 00:00:00 2001 From: Federico Mena Quintero Date: Tue, 13 Apr 2004 01:11:34 +0000 Subject: Added documentation to all the signals. 2004-04-12 Federico Mena Quintero * gtk/gtkfilechooser.c (gtk_file_chooser_class_init): Added documentation to all the signals. --- docs/reference/ChangeLog | 5 + docs/reference/gtk/tmpl/gtkfilechooser.sgml | 156 ++++++++++++++++++++++++++++ 2 files changed, 161 insertions(+) (limited to 'docs') diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog index 99e0ff8575..04357bdc71 100644 --- a/docs/reference/ChangeLog +++ b/docs/reference/ChangeLog @@ -1,3 +1,8 @@ +2004-04-12 Federico Mena Quintero + + * gtk/tmpl/gtkfilechooser.sgml: Added documentation about + GtkFileChooserDefault's key binding signals. + 2004-03-26 Federico Mena Quintero * gtk/tmpl/gtkfilechooserdialog.sgml: Added a section about using diff --git a/docs/reference/gtk/tmpl/gtkfilechooser.sgml b/docs/reference/gtk/tmpl/gtkfilechooser.sgml index 6e7d419162..1d1decca47 100644 --- a/docs/reference/gtk/tmpl/gtkfilechooser.sgml +++ b/docs/reference/gtk/tmpl/gtkfilechooser.sgml @@ -116,6 +116,162 @@ update_preview_cb (GtkFileChooser *file_chooser, gpointer data) + + Key Bindings + + + Internally, GTK+ implements a file chooser's graphical user + interface with the private + GtkFileChooserDefaultClass. This + widget has several key + bindings and their associated signals. This section + describes the available key binding signals. + + + + The "GtkFileChooserDefault::location-popup" signal + + + void user_function (GtkFileChooserDefault *chooser, + gpointer user_data); + + + + This is used to make the file chooser show a "Location" + dialog which the user can use to manually type the name of + the file he wishes to select. By default this is bound to + ControlL. + + + + + chooser : + + + the object which received the signal. + + + + + user_data : + + + user data set when the signal handler was connected. + + + + + + + + The "GtkFileChooserDefault::up-folder" signal + + + void user_function (GtkFileChooserDefault *chooser, + gpointer user_data); + + + + This is used to make the file chooser go to the parent of + the current folder in the file hierarchy. By default this + is bound to + AltUp. + + + + + chooser : + + + the object which received the signal. + + + + + user_data : + + + user data set when the signal handler was connected. + + + + + + + + The "GtkFileChooserDefault::down-folder" signal + + + void user_function (GtkFileChooserDefault *chooser, + gpointer user_data); + + + + This is used to make the file chooser go to a child of the + current folder in the file hierarchy. The subfolder that + will be used is displayed in the path bar widget of the file + chooser. For example, if the path bar is showing + "/foo/bar/baz", then this will cause + the file chooser to switch to the "baz" subfolder. By + default this is bound to + AltDown. + + + + + chooser : + + + the object which received the signal. + + + + + user_data : + + + user data set when the signal handler was connected. + + + + + + + + The "GtkFileChooserDefault::home-folder" signal + + + void user_function (GtkFileChooserDefault *chooser, + gpointer user_data); + + + + This is used to make the file chooser show the user's home + folder in the file list. By default this is bound to + AltHome. + + + + + chooser : + + + the object which received the signal. + + + + + user_data : + + + user data set when the signal handler was connected. + + + + + + + #GtkFileChooserDialog, #GtkFileChooserWidget -- cgit v1.2.1