Sophie

Sophie

distrib > Mandriva > 2010.0 > i586 > media > contrib-release > by-pkgid > 1bbf51ece72e40a5f40ad48678e7c5a5 > files > 647

libgnome32-devel-1.4.2-22mdv2009.1.i586.rpm

<!-- ##### SECTION Title ##### -->
gnome-popup-help

<!-- ##### SECTION Short_Description ##### -->
  A popup-help system for GtkWidgets.

<!-- ##### SECTION Long_Description ##### -->
<para>
  This will add a popup-menu to a non GTK_WIDGET_NO_WINDOW() widget.  It
  also has the ability to add "cut", "copy" and "paste" to #GtkEditable
  widgets if needed.  It is important to not run this on a widget
  without a window, as doing so can lead to stuck pointer grabs.  This
  function should be used where possible everywhere else.
</para>

<!-- ##### SECTION See_Also ##### -->
<para>
  #GnomePopupMenu
</para>

<!-- ##### MACRO gnome_widget_add_help ##### -->
<para>
This is the same as gnome_widget_add_help_with_uidata() but without the
options for the extra menu fields.
</para>

@widget: The widget to add the popup help to.
@help: The help message text.


<!-- ##### FUNCTION gnome_widget_add_help_with_uidata ##### -->
<para>
This creates a popup menu on @widget with one entry.  The menu,
invoked by pressing button three on the widget, will have one entry entitled:
"Help with this."  Selecting this entry will bring up a tooltip with the help
variable as its text.  In addition, if the widget is a descendent of
#GtkEditable, it will add "cut", "copy", and "paste" to the menu.  If @help
is NULL, then it will <emphasis>just</emphasis> add the "cut", "copy", and
"paste".  Finally, if @menuinfo is non-NULL, it will append the menu defined
by it on the end of the popup menu, with @user_data passed to the callbacks.
This function currently only works on non GTK_WIDGET_NO_WINDOW () widgets
(ie. it only works on widgets with windows.)  If you would actually like a
handle to the popup menu, call gnome_popup_menu_get() as normal.
</para>

@widget: The widget to add the popup help to.
@help: The help message text.
@menuinfo: The template for possible additional menu items.
@user_data: The user data to be passed to menu callbacks.