Re: keyboard_tooltip

[José Alburquerque <jaalburquerque gmail com>]

On Tue, 2011-11-08 at 01:32 -0500, José Alburquerque wrote:
> On Mon, 2011-11-07 at 18:45 +0000, Carlos Lopez Gonzalez wrote:
> > Hi!
> > I'm implementing tooltips for a tree view. When defining the signal
> > handler:
> > 
> > 
> > on_my_tree_view_tolltip_query(int x, int y, bool keyboard_tooltip,
> > const Glib::RefPtr<Gtk::Tooltip>& tooltip);
> > 
> > 
> > as shown in the Tooltip example
> > http://developer.gnome.org/gtkmm-tutorial/unstable/sec-tooltips.html
> > 
> > 
> > I don't know what to do or what does mean the 'keyboard_tooltip'
> > argument.
> 
> The keyboard_tooltip argument tells whether the signal_query_tooltip()
> signal was triggered not by a mouse movement but by means of using key
> presses on the keyboard.  If that argument is true, the x and y values
> to the slot are invalid and cannot be used to determine if the tooltip
> should be shown.  

Actually, if the argument is true it means that the x and y values
cannot be used to determine *where* the tooltip should be shown.

> This is all explained in the C docs for the
> "tooltip-query" signal of the GtkWidget class:
> 
> http://developer.gnome.org/gtk3/stable/GtkWidget.html#GtkWidget-query-tooltip
> 
> Maybe gmmproc could be enhanced to include such docs for signals?
> 
> > 
> > Is there any documentation on that?
> > 
> > 
> > Also I've found that there is a documentation mistake. At the start of
> > the previous link says:
> > 
> > 
> > "Tooltips are the little information windows that pop up when you
> > leave your pointer over a widget for a few seconds. Use
> > set_tooltip_text() to set a text string as a tooltip on any Widget.
> > Gtk::ToolItems are not Widgets, but have the same method for
> > convenience. Gtk::Tooltip is used for more advanced tooltip usage,
> > such as showing an image as well as text."
> 
> The Gtk::ToolItem sentence is probably not worded properly.
> 
> > 
> > Isn't " Gtk::ToolItems are not Widgets, but have the same method for
> > convenience." text out of context?
> > 
> > 
> > Thanks in advance.
> > Carlos
> > 
> > _______________________________________________
> > gtkmm-list mailing list
> > gtkmm-list gnome org
> > http://mail.gnome.org/mailman/listinfo/gtkmm-list
> 

-- 
José