export gtk_window_activate_key() (Request from Tim Janik)

Sun Feb 29 20:34:06 2004  Owen Taylor  <otaylor@redhat.com>

        * gtk/gtkwindow.[ch] gtk/gtkmenushell.c: export
        gtk_window_activate_key() (Request from Tim Janik)

9 files changed, 38 insertions, 8 deletions

diff --git a/ChangeLog b/ChangeLog
index 36c6373e4..4e73b4271 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+Sun Feb 29 20:34:06 2004  Owen Taylor  <otaylor@redhat.com>
+
+	* gtk/gtkwindow.[ch] gtk/gtkmenushellx.c: export
+	gtk_window_activate_key() (Request from Tim Janik)
+
 Mon Mar  1 01:00:11 2004  Matthias Clasen  <maclas@gmx.de>
 
 	* gtk/gtktextview.c (gtk_text_view_drag_data_received): 
diff --git a/ChangeLog.pre-2-10 b/ChangeLog.pre-2-10
index 36c6373e4..4e73b4271 100644
--- a/ChangeLog.pre-2-10
+++ b/ChangeLog.pre-2-10
@@ -1,3 +1,8 @@
+Sun Feb 29 20:34:06 2004  Owen Taylor  <otaylor@redhat.com>
+
+	* gtk/gtkwindow.[ch] gtk/gtkmenushellx.c: export
+	gtk_window_activate_key() (Request from Tim Janik)
+
 Mon Mar  1 01:00:11 2004  Matthias Clasen  <maclas@gmx.de>
 
 	* gtk/gtktextview.c (gtk_text_view_drag_data_received): 
diff --git a/ChangeLog.pre-2-4 b/ChangeLog.pre-2-4
index 36c6373e4..4e73b4271 100644
--- a/ChangeLog.pre-2-4
+++ b/ChangeLog.pre-2-4
@@ -1,3 +1,8 @@
+Sun Feb 29 20:34:06 2004  Owen Taylor  <otaylor@redhat.com>
+
+	* gtk/gtkwindow.[ch] gtk/gtkmenushellx.c: export
+	gtk_window_activate_key() (Request from Tim Janik)
+
 Mon Mar  1 01:00:11 2004  Matthias Clasen  <maclas@gmx.de>
 
 	* gtk/gtktextview.c (gtk_text_view_drag_data_received): 
diff --git a/ChangeLog.pre-2-6 b/ChangeLog.pre-2-6
index 36c6373e4..4e73b4271 100644
--- a/ChangeLog.pre-2-6
+++ b/ChangeLog.pre-2-6
@@ -1,3 +1,8 @@
+Sun Feb 29 20:34:06 2004  Owen Taylor  <otaylor@redhat.com>
+
+	* gtk/gtkwindow.[ch] gtk/gtkmenushellx.c: export
+	gtk_window_activate_key() (Request from Tim Janik)
+
 Mon Mar  1 01:00:11 2004  Matthias Clasen  <maclas@gmx.de>
 
 	* gtk/gtktextview.c (gtk_text_view_drag_data_received): 
diff --git a/ChangeLog.pre-2-8 b/ChangeLog.pre-2-8
index 36c6373e4..4e73b4271 100644
--- a/ChangeLog.pre-2-8
+++ b/ChangeLog.pre-2-8
@@ -1,3 +1,8 @@
+Sun Feb 29 20:34:06 2004  Owen Taylor  <otaylor@redhat.com>
+
+	* gtk/gtkwindow.[ch] gtk/gtkmenushellx.c: export
+	gtk_window_activate_key() (Request from Tim Janik)
+
 Mon Mar  1 01:00:11 2004  Matthias Clasen  <maclas@gmx.de>
 
 	* gtk/gtktextview.c (gtk_text_view_drag_data_received): 
diff --git a/docs/reference/gtk/gtk-sections.txt b/docs/reference/gtk/gtk-sections.txt
index 1c757027c..55932c040 100644
--- a/docs/reference/gtk/gtk-sections.txt
+++ b/docs/reference/gtk/gtk-sections.txt
@@ -4380,6 +4380,7 @@ gtk_window_list_toplevels
 gtk_window_add_mnemonic
 gtk_window_remove_mnemonic
 gtk_window_mnemonic_activate
+gtk_window_activate_key
 gtk_window_get_focus
 gtk_window_set_focus
 gtk_window_set_default
diff --git a/gtk/gtkmenushell.c b/gtk/gtkmenushell.c
index 514d9b5aa..b90709152 100644
--- a/gtk/gtkmenushell.c
+++ b/gtk/gtkmenushell.c
@@ -585,7 +585,7 @@ gtk_menu_shell_key_press (GtkWidget	*widget,
 
   toplevel = gtk_widget_get_toplevel (widget);
   if (GTK_IS_WINDOW (toplevel) &&
-      _gtk_window_activate_key (GTK_WINDOW (toplevel), event))
+      gtk_window_activate_key (GTK_WINDOW (toplevel), event))
     return TRUE;
 
   return FALSE;
diff --git a/gtk/gtkwindow.c b/gtk/gtkwindow.c
index 0e3c5f3db..034edf240 100644
--- a/gtk/gtkwindow.c
+++ b/gtk/gtkwindow.c
@@ -4198,7 +4198,7 @@ gtk_window_key_press_event (GtkWidget   *widget,
   /* Check for mnemonics and accelerators
    */
   if (!handled)
-    handled = _gtk_window_activate_key (window, event);
+    handled = gtk_window_activate_key (window, event);
 
   if (!handled)
     {
@@ -7067,17 +7067,20 @@ gtk_window_free_key_hash (GtkWindow *window)
 }
 
 /**
- * _gtk_window_activate_key:
+ * gtk_window_activate_key:
  * @window: a #GtkWindow
  * @event: a #GdkEventKey
  * 
- * Activates mnemonics and accelerators for this #GtKWindow
+ * Activates mnemonics and accelerators for this #GtkWindow. This is normally
+ * called by the default ::key_press_event handler for toplevel windows,
+ * however in some cases it may be useful to call this directly when
+ * overriding the standard key handling for a toplevel window.
  * 
  * Return value: %TRUE if a mnemonic or accelerator was found and activated.
  **/
 gboolean
-_gtk_window_activate_key (GtkWindow   *window,
-			  GdkEventKey *event)
+gtk_window_activate_key (GtkWindow   *window,
+			 GdkEventKey *event)
 {
   GtkKeyHash *key_hash = g_object_get_data (G_OBJECT (window), "gtk-window-key-hash");
   GtkWindowKeyEntry *found_entry = NULL;
diff --git a/gtk/gtkwindow.h b/gtk/gtkwindow.h
index 439a5cefe..0b0c163b4 100644
--- a/gtk/gtkwindow.h
+++ b/gtk/gtkwindow.h
@@ -285,6 +285,9 @@ void     gtk_window_set_mnemonic_modifier (GtkWindow       *window,
 					   GdkModifierType  modifier);
 GdkModifierType gtk_window_get_mnemonic_modifier (GtkWindow *window);
 
+gboolean gtk_window_activate_key          (GtkWindow        *window,
+					   GdkEventKey      *event);
+
 void     gtk_window_present       (GtkWindow *window);
 void     gtk_window_iconify       (GtkWindow *window);
 void     gtk_window_deiconify     (GtkWindow *window);
@@ -370,8 +373,6 @@ void            _gtk_window_constrain_size     (GtkWindow *window,
 						gint      *new_width,
 						gint      *new_height);
 GtkWindowGroup *_gtk_window_get_group          (GtkWindow *window);
-gboolean        _gtk_window_activate_key       (GtkWindow   *window,
-						GdkEventKey *event);
 
 void            _gtk_window_set_has_toplevel_focus (GtkWindow *window,
 						    gboolean   has_toplevel_focus);