summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
author20:21:28 Tim Janik <timj@imendio.com>2007-10-01 18:21:54 +0000
committerTim Janik <timj@src.gnome.org>2007-10-01 18:21:54 +0000
commit8d503f2a90ae5e5f3aa1fb488148c10aca8a4b0b (patch)
tree4a5927b96c4b713c681df6ac8a746369593d8f66 /docs
parent6e3df276df9fbb9b03be072908fe2702659adc32 (diff)
downloadgdk-pixbuf-8d503f2a90ae5e5f3aa1fb488148c10aca8a4b0b.tar.gz
reworded push_in description with Owen's help, fixes bug #482034.
2007-10-01 20:21:28 Tim Janik <timj@imendio.com> * gtk/tmpl/gtkmenu.sgml: reworded push_in description with Owen's help, fixes bug #482034. svn path=/trunk/; revision=18872
Diffstat (limited to 'docs')
-rw-r--r--docs/reference/ChangeLog5
-rw-r--r--docs/reference/gtk/tmpl/gtkmenu.sgml12
2 files changed, 15 insertions, 2 deletions
diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog
index 281b1edf9..c8dc45737 100644
--- a/docs/reference/ChangeLog
+++ b/docs/reference/ChangeLog
@@ -1,3 +1,8 @@
+2007-10-01 20:21:28 Tim Janik <timj@imendio.com>
+
+ * gtk/tmpl/gtkmenu.sgml: reworded push_in description with Owen's
+ help, fixes bug #482034.
+
2007-09-13 Matthias Clasen <mclasen@redhat.com>
* === Released 2.12.0 ===
diff --git a/docs/reference/gtk/tmpl/gtkmenu.sgml b/docs/reference/gtk/tmpl/gtkmenu.sgml
index 18f7fec9d..7fde58e57 100644
--- a/docs/reference/gtk/tmpl/gtkmenu.sgml
+++ b/docs/reference/gtk/tmpl/gtkmenu.sgml
@@ -394,8 +394,16 @@ and @y parameters to the coordinates where the menu is to be drawn.
menu shall be drawn. This is an output parameter.
@y: address of the #gint representing the vertical position where the
menu shall be drawn. This is an output parameter.
-@push_in: whether the first menu item should be offset (pushed in) to be
- aligned with the menu popup position (only useful for GtkOptionMenu).
+@push_in: This parameter controls how menus placed outside the monitor are handled.
+ If this is set to TRUE and part of the menu is outside the monitor then
+ GTK+ pushes the window into the visible area, effectively modifying the
+ popup position.
+ Note that moving and possibly resizing the menu around will alter the
+ scroll position to keep the menu items "in place", i.e. at the same monitor
+ position they would have been without resizing.
+ In practice, this behavior is only useful for combobox popups or option
+ menus and cannot be used to simply confine a menu to monitor boundaries
+ (in which case the scroll offset shouldn't be changed).
@user_data: the data supplied by the user in the gtk_menu_popup() @data
parameter.