diff options
author | 20:21:28 Tim Janik <timj@imendio.com> | 2007-10-01 18:21:54 +0000 |
---|---|---|
committer | Tim Janik <timj@src.gnome.org> | 2007-10-01 18:21:54 +0000 |
commit | 8d503f2a90ae5e5f3aa1fb488148c10aca8a4b0b (patch) | |
tree | 4a5927b96c4b713c681df6ac8a746369593d8f66 | |
parent | 6e3df276df9fbb9b03be072908fe2702659adc32 (diff) | |
download | gtk+-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
-rw-r--r-- | docs/reference/ChangeLog | 5 | ||||
-rw-r--r-- | docs/reference/gtk/tmpl/gtkmenu.sgml | 12 |
2 files changed, 15 insertions, 2 deletions
diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog index 281b1edf9c..c8dc457376 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 18f7fec9d1..7fde58e579 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. |