GNOME Bugzilla – Bug 304103
Gtk::Widget:"show_help" signal not wrapped
Last modified: 2016-11-05 08:50:37 UTC
Both of these signals are important for accessibility keyboard navigation and are trivially wrapped. Do you have any objection to me doing this?
We ususually don't wrap the accessibility ("keybinding" or G_SIGNAL_ACTION) signals. The GTK+ developers told us that these should never be used outside of GTK+ and we had problems between 2.0 and 2.2 when they changed the signatures of the signals, breaking our build. From their point of view they were private API that we shouldn't have been using. But maybe this is a special case. You could ask on gtk-list whether you should be using them to do whatever it is you are trying to do.
Well, in the case of 'popup_menu' that really makes no sense. Any widget that has a popup menu should attach a callback to this signal. Otherwise it's incredibly difficult to respect keybindings. Attaching to key_press and hard coding detecting for the menu and shift-f10 keys isn't acceptable because the user can customise the keybinding for showing the popup menu. As it's possible to write a widget in gtkmm, then it must be necessary to have access to the popup_menu signal. It most certainly is not an internal gtk+ implementation detail. http://developer.gnome.org/doc/API/2.0/gtk/gtk-migrating-checklist.html#checklist-popup-menu
Again, please ask on gtk-list whether gtkmm should wrap this.
If you won't do that, then this is not major.
I sent an email to gtk-list. Apparently it never made it through moderation. I'll have to try again.
Murray, GTK+ dicumentation is quite clear on this. The popup_menu is supposed to be used by applications. It's part of the migration check list.
Apologies for spam... ensuring Sun a11y folks are cc'ed on all current accessibility bugs.
I've still had no luck getting the GTK+ developers to document that these keybindings are an exception to the usual don't-wrap-keybinding-signals rule.
I have wrapped popup-menu in svn trunk, but I still see no evidence that show-help is meant to be used. See bug #339205.
Maybe it would help to know of an application that uses this signal.
The GtkWidget::popup-menu signal was wrapped in gtkmm long ago. The GtkWidget::show-help signal has been removed from gtk+'s master branch, meaning (I suppose) that it will not be included in gtk+-4.0. This bug can be closed now.