summaryrefslogtreecommitdiffstats
path: root/devel-docs/libgimpwidgets/html/libgimpwidgets-GimpHelpUI.html
diff options
context:
space:
mode:
Diffstat (limited to 'devel-docs/libgimpwidgets/html/libgimpwidgets-GimpHelpUI.html')
-rw-r--r--devel-docs/libgimpwidgets/html/libgimpwidgets-GimpHelpUI.html409
1 files changed, 409 insertions, 0 deletions
diff --git a/devel-docs/libgimpwidgets/html/libgimpwidgets-GimpHelpUI.html b/devel-docs/libgimpwidgets/html/libgimpwidgets-GimpHelpUI.html
new file mode 100644
index 0000000..ce1cb0f
--- /dev/null
+++ b/devel-docs/libgimpwidgets/html/libgimpwidgets-GimpHelpUI.html
@@ -0,0 +1,409 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+<title>GimpHelpUI: GIMP Widgets Library Reference Manual</title>
+<meta name="generator" content="DocBook XSL Stylesheets Vsnapshot">
+<link rel="home" href="index.html" title="GIMP Widgets Library Reference Manual">
+<link rel="up" href="libgimpwidgets-utils.html" title="Part VI. GIMP Widgets Utilities">
+<link rel="prev" href="libgimpwidgets-GimpCairoUtils.html" title="GimpCairo-utils">
+<link rel="next" href="libgimpwidgets-GimpQueryBox.html" title="GimpQueryBox">
+<meta name="generator" content="GTK-Doc V1.32 (XML mode)">
+<link rel="stylesheet" href="style.css" type="text/css">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="5"><tr valign="middle">
+<td width="100%" align="left" class="shortcuts">
+<a href="#" class="shortcut">Top</a><span id="nav_description">  <span class="dim">|</span> 
+ <a href="#libgimpwidgets-GimpHelpUI.description" class="shortcut">Description</a></span>
+</td>
+<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
+<td><a accesskey="u" href="libgimpwidgets-utils.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
+<td><a accesskey="p" href="libgimpwidgets-GimpCairoUtils.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
+<td><a accesskey="n" href="libgimpwidgets-GimpQueryBox.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
+</tr></table>
+<div class="refentry">
+<a name="libgimpwidgets-GimpHelpUI"></a><div class="titlepage"></div>
+<div class="refnamediv"><table width="100%"><tr>
+<td valign="top">
+<h2><span class="refentrytitle"><a name="libgimpwidgets-GimpHelpUI.top_of_page"></a>GimpHelpUI</span></h2>
+<p>GimpHelpUI — Functions for setting tooltip and help identifier
+used by the GIMP help system.</p>
+</td>
+<td class="gallery_image" valign="top" align="right"></td>
+</tr></table></div>
+<div class="refsect1">
+<a name="libgimpwidgets-GimpHelpUI.functions"></a><h2>Functions</h2>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
+<colgroup>
+<col width="150px" class="functions_proto_type">
+<col class="functions_proto_name">
+</colgroup>
+<tbody>
+<tr>
+<td class="function_type">
+<span class="returnvalue">void</span>
+</td>
+<td class="function_name">
+<span class="c_punctuation">(</span><a class="link" href="libgimpwidgets-GimpHelpUI.html#GimpHelpFunc" title="GimpHelpFunc ()">*GimpHelpFunc</a><span class="c_punctuation">)</span> <span class="c_punctuation">()</span>
+</td>
+</tr>
+<tr>
+<td class="function_type">
+<span class="returnvalue">void</span>
+</td>
+<td class="function_name">
+<a class="link" href="libgimpwidgets-GimpHelpUI.html#gimp-help-enable-tooltips" title="gimp_help_enable_tooltips ()">gimp_help_enable_tooltips</a> <span class="c_punctuation">()</span>
+</td>
+</tr>
+<tr>
+<td class="function_type">
+<span class="returnvalue">void</span>
+</td>
+<td class="function_name">
+<a class="link" href="libgimpwidgets-GimpHelpUI.html#gimp-help-disable-tooltips" title="gimp_help_disable_tooltips ()">gimp_help_disable_tooltips</a> <span class="c_punctuation">()</span>
+</td>
+</tr>
+<tr>
+<td class="function_type">
+<span class="returnvalue">void</span>
+</td>
+<td class="function_name">
+<a class="link" href="libgimpwidgets-GimpHelpUI.html#gimp-standard-help-func" title="gimp_standard_help_func ()">gimp_standard_help_func</a> <span class="c_punctuation">()</span>
+</td>
+</tr>
+<tr>
+<td class="function_type">
+<span class="returnvalue">void</span>
+</td>
+<td class="function_name">
+<a class="link" href="libgimpwidgets-GimpHelpUI.html#gimp-help-connect" title="gimp_help_connect ()">gimp_help_connect</a> <span class="c_punctuation">()</span>
+</td>
+</tr>
+<tr>
+<td class="function_type">
+<span class="returnvalue">void</span>
+</td>
+<td class="function_name">
+<a class="link" href="libgimpwidgets-GimpHelpUI.html#gimp-help-set-help-data" title="gimp_help_set_help_data ()">gimp_help_set_help_data</a> <span class="c_punctuation">()</span>
+</td>
+</tr>
+<tr>
+<td class="function_type">
+<span class="returnvalue">void</span>
+</td>
+<td class="function_name">
+<a class="link" href="libgimpwidgets-GimpHelpUI.html#gimp-help-set-help-data-with-markup" title="gimp_help_set_help_data_with_markup ()">gimp_help_set_help_data_with_markup</a> <span class="c_punctuation">()</span>
+</td>
+</tr>
+<tr>
+<td class="function_type">
+<span class="returnvalue">void</span>
+</td>
+<td class="function_name">
+<a class="link" href="libgimpwidgets-GimpHelpUI.html#gimp-context-help" title="gimp_context_help ()">gimp_context_help</a> <span class="c_punctuation">()</span>
+</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<div class="refsect1">
+<a name="libgimpwidgets-GimpHelpUI.other"></a><h2>Types and Values</h2>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
+<colgroup>
+<col width="150px" class="other_proto_type">
+<col class="other_proto_name">
+</colgroup>
+<tbody><tr>
+<td class="define_keyword">#define</td>
+<td class="function_name"><a class="link" href="libgimpwidgets-GimpHelpUI.html#GIMP-HELP-ID:CAPS" title="GIMP_HELP_ID">GIMP_HELP_ID</a></td>
+</tr></tbody>
+</table></div>
+</div>
+<div class="refsect1">
+<a name="libgimpwidgets-GimpHelpUI.description"></a><h2>Description</h2>
+<p>Functions for setting tooltip and help identifier used by the GIMP
+help system.</p>
+</div>
+<div class="refsect1">
+<a name="libgimpwidgets-GimpHelpUI.functions_details"></a><h2>Functions</h2>
+<div class="refsect2">
+<a name="GimpHelpFunc"></a><h3>GimpHelpFunc ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>
+<span class="c_punctuation">(</span>*GimpHelpFunc<span class="c_punctuation">)</span> (<em class="parameter"><code>const <span class="type">gchar</span> *help_id</code></em>,
+ <em class="parameter"><code><span class="type">gpointer</span> help_data</code></em>);</pre>
+<p>This is the prototype for all functions you pass as <em class="parameter"><code>help_func</code></em>
+ to
+the various GIMP dialog constructors like <a class="link" href="GimpDialog.html#gimp-dialog-new" title="gimp_dialog_new ()"><code class="function">gimp_dialog_new()</code></a>,
+<a class="link" href="libgimpwidgets-GimpQueryBox.html#gimp-query-int-box" title="gimp_query_int_box ()"><code class="function">gimp_query_int_box()</code></a> etc.</p>
+<p>Help IDs are textual identifiers the help system uses to figure
+which page to display.</p>
+<p>All these dialog constructors functions call <a class="link" href="libgimpwidgets-GimpHelpUI.html#gimp-help-connect" title="gimp_help_connect ()"><code class="function">gimp_help_connect()</code></a>.</p>
+<p>In most cases it will be ok to use <a class="link" href="libgimpwidgets-GimpHelpUI.html#gimp-standard-help-func" title="gimp_standard_help_func ()"><code class="function">gimp_standard_help_func()</code></a> which
+does nothing but passing the <em class="parameter"><code>help_id</code></em>
+ string to <a href="/local/head/share/gtk-doc/html/libgimp3/libgimp3-gimphelp.html#gimp-help"><code class="function">gimp_help()</code></a>. If
+your plug-in needs some more sophisticated help handling you can
+provide your own <em class="parameter"><code>help_func</code></em>
+ which has to call <a href="/local/head/share/gtk-doc/html/libgimp3/libgimp3-gimphelp.html#gimp-help"><code class="function">gimp_help()</code></a> to
+actually display the help.</p>
+<div class="refsect3">
+<a name="GimpHelpFunc.parameters"></a><h4>Parameters</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
+<colgroup>
+<col width="150px" class="parameters_name">
+<col class="parameters_description">
+<col width="200px" class="parameters_annotations">
+</colgroup>
+<tbody>
+<tr>
+<td class="parameter_name"><p>help_id</p></td>
+<td class="parameter_description"><p>the help ID</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>help_data</p></td>
+<td class="parameter_description"><p>the help user data</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gimp-help-enable-tooltips"></a><h3>gimp_help_enable_tooltips ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>
+gimp_help_enable_tooltips (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
+<p>Enable tooltips to be shown in the GIMP user interface.</p>
+<p>As a plug-in author, you don't need to care about this as this
+function is called for you from <a href="/local/head/share/gtk-doc/html/libgimp3/libgimp3-gimpui.html#gimp-ui-init"><code class="function">gimp_ui_init()</code></a>. This ensures that
+the user setting from the GIMP preferences dialog is respected in
+all plug-in dialogs.</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gimp-help-disable-tooltips"></a><h3>gimp_help_disable_tooltips ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>
+gimp_help_disable_tooltips (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
+<p>Disable tooltips to be shown in the GIMP user interface.</p>
+<p>As a plug-in author, you don't need to care about this as this
+function is called for you from <a href="/local/head/share/gtk-doc/html/libgimp3/libgimp3-gimpui.html#gimp-ui-init"><code class="function">gimp_ui_init()</code></a>. This ensures that
+the user setting from the GIMP preferences dialog is respected in
+all plug-in dialogs.</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gimp-standard-help-func"></a><h3>gimp_standard_help_func ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>
+gimp_standard_help_func (<em class="parameter"><code>const <span class="type">gchar</span> *help_id</code></em>,
+ <em class="parameter"><code><span class="type">gpointer</span> help_data</code></em>);</pre>
+<p>This is the standard GIMP help function which does nothing but calling
+<a href="/local/head/share/gtk-doc/html/libgimp3/libgimp3-gimphelp.html#gimp-help"><code class="function">gimp_help()</code></a>. It is the right function to use in almost all cases.</p>
+<div class="refsect3">
+<a name="gimp-standard-help-func.parameters"></a><h4>Parameters</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
+<colgroup>
+<col width="150px" class="parameters_name">
+<col class="parameters_description">
+<col width="200px" class="parameters_annotations">
+</colgroup>
+<tbody>
+<tr>
+<td class="parameter_name"><p>help_id</p></td>
+<td class="parameter_description"><p>A unique help identifier.</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>help_data</p></td>
+<td class="parameter_description"><p>The <em class="parameter"><code>help_data</code></em>
+passed to <a class="link" href="libgimpwidgets-GimpHelpUI.html#gimp-help-connect" title="gimp_help_connect ()"><code class="function">gimp_help_connect()</code></a>.</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gimp-help-connect"></a><h3>gimp_help_connect ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>
+gimp_help_connect (<em class="parameter"><code><a href="https://developer.gnome.org/gtk3/GtkWidget.html#GtkWidget-struct"><span class="type">GtkWidget</span></a> *widget</code></em>,
+ <em class="parameter"><code><a class="link" href="libgimpwidgets-GimpHelpUI.html#GimpHelpFunc" title="GimpHelpFunc ()"><span class="type">GimpHelpFunc</span></a> help_func</code></em>,
+ <em class="parameter"><code>const <span class="type">gchar</span> *help_id</code></em>,
+ <em class="parameter"><code><span class="type">gpointer</span> help_data</code></em>);</pre>
+<p>Note that this function is automatically called by all libgimp dialog
+constructors. You only have to call it for windows/dialogs you created
+"manually".</p>
+<div class="refsect3">
+<a name="gimp-help-connect.parameters"></a><h4>Parameters</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
+<colgroup>
+<col width="150px" class="parameters_name">
+<col class="parameters_description">
+<col width="200px" class="parameters_annotations">
+</colgroup>
+<tbody>
+<tr>
+<td class="parameter_name"><p>widget</p></td>
+<td class="parameter_description"><p>The widget you want to connect the help accelerator for. Will
+be a <a href="https://developer.gnome.org/gtk3/GtkWindow.html#GtkWindow-struct"><span class="type">GtkWindow</span></a> in most cases.</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>help_func</p></td>
+<td class="parameter_description"><p>The function which will be called if the user presses "F1".</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>help_id</p></td>
+<td class="parameter_description"><p>The <em class="parameter"><code>help_id</code></em>
+which will be passed to <em class="parameter"><code>help_func</code></em>
+.</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>help_data</p></td>
+<td class="parameter_description"><p>The <em class="parameter"><code>help_data</code></em>
+pointer which will be passed to <em class="parameter"><code>help_func</code></em>
+.</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gimp-help-set-help-data"></a><h3>gimp_help_set_help_data ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>
+gimp_help_set_help_data (<em class="parameter"><code><a href="https://developer.gnome.org/gtk3/GtkWidget.html#GtkWidget-struct"><span class="type">GtkWidget</span></a> *widget</code></em>,
+ <em class="parameter"><code>const <span class="type">gchar</span> *tooltip</code></em>,
+ <em class="parameter"><code>const <span class="type">gchar</span> *help_id</code></em>);</pre>
+<p>The reason why we don't use <a href="https://developer.gnome.org/gtk3/GtkWidget.html#gtk-widget-set-tooltip-text"><code class="function">gtk_widget_set_tooltip_text()</code></a> is that
+elements in the GIMP user interface should, if possible, also have
+a <em class="parameter"><code>help_id</code></em>
+ set for context-sensitive help.</p>
+<p>This function can be called with <span class="type">NULL</span> for <em class="parameter"><code>tooltip</code></em>
+. Use this feature
+if you want to set a help link for a widget which shouldn't have
+a visible tooltip.</p>
+<div class="refsect3">
+<a name="gimp-help-set-help-data.parameters"></a><h4>Parameters</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
+<colgroup>
+<col width="150px" class="parameters_name">
+<col class="parameters_description">
+<col width="200px" class="parameters_annotations">
+</colgroup>
+<tbody>
+<tr>
+<td class="parameter_name"><p>widget</p></td>
+<td class="parameter_description"><p>The <a href="https://developer.gnome.org/gtk3/GtkWidget.html#GtkWidget-struct"><span class="type">GtkWidget</span></a> you want to set a <em class="parameter"><code>tooltip</code></em>
+and/or <em class="parameter"><code>help_id</code></em>
+for.</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>tooltip</p></td>
+<td class="parameter_description"><p>The text for this widget's tooltip (or <code class="literal">NULL</code>).</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>help_id</p></td>
+<td class="parameter_description"><p>The <em class="parameter"><code>help_id</code></em>
+for the <span class="type">GtkTipsQuery</span> tooltips inspector.</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gimp-help-set-help-data-with-markup"></a><h3>gimp_help_set_help_data_with_markup ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>
+gimp_help_set_help_data_with_markup (<em class="parameter"><code><a href="https://developer.gnome.org/gtk3/GtkWidget.html#GtkWidget-struct"><span class="type">GtkWidget</span></a> *widget</code></em>,
+ <em class="parameter"><code>const <span class="type">gchar</span> *tooltip</code></em>,
+ <em class="parameter"><code>const <span class="type">gchar</span> *help_id</code></em>);</pre>
+<p>Just like <a class="link" href="libgimpwidgets-GimpHelpUI.html#gimp-help-set-help-data" title="gimp_help_set_help_data ()"><code class="function">gimp_help_set_help_data()</code></a>, but supports to pass text
+which is marked up with <GTKDOCLINK HREF="PangoMarkupFormat">Pango
+text markup language</GTKDOCLINK>.</p>
+<div class="refsect3">
+<a name="gimp-help-set-help-data-with-markup.parameters"></a><h4>Parameters</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
+<colgroup>
+<col width="150px" class="parameters_name">
+<col class="parameters_description">
+<col width="200px" class="parameters_annotations">
+</colgroup>
+<tbody>
+<tr>
+<td class="parameter_name"><p>widget</p></td>
+<td class="parameter_description"><p>The <a href="https://developer.gnome.org/gtk3/GtkWidget.html#GtkWidget-struct"><span class="type">GtkWidget</span></a> you want to set a <em class="parameter"><code>tooltip</code></em>
+and/or <em class="parameter"><code>help_id</code></em>
+for.</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>tooltip</p></td>
+<td class="parameter_description"><p>The markup for this widget's tooltip (or <code class="literal">NULL</code>).</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>help_id</p></td>
+<td class="parameter_description"><p>The <em class="parameter"><code>help_id</code></em>
+for the <span class="type">GtkTipsQuery</span> tooltips inspector.</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<p class="since">Since: <a class="link" href="api-index-2-6.html#api-index-2.6">2.6</a></p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gimp-context-help"></a><h3>gimp_context_help ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>
+gimp_context_help (<em class="parameter"><code><a href="https://developer.gnome.org/gtk3/GtkWidget.html#GtkWidget-struct"><span class="type">GtkWidget</span></a> *widget</code></em>);</pre>
+<p>This function invokes the context help inspector.</p>
+<p>The mouse cursor will turn turn into a question mark and the user can
+click on any widget of the application which started the inspector.</p>
+<p>If the widget the user clicked on has a <em class="parameter"><code>help_id</code></em>
+ string attached
+(see <a class="link" href="libgimpwidgets-GimpHelpUI.html#gimp-help-set-help-data" title="gimp_help_set_help_data ()"><code class="function">gimp_help_set_help_data()</code></a>), the corresponding help page will
+be displayed. Otherwise the help system will ascend the widget hierarchy
+until it finds an attached <em class="parameter"><code>help_id</code></em>
+ string (which should be the
+case at least for every window/dialog).</p>
+<div class="refsect3">
+<a name="gimp-context-help.parameters"></a><h4>Parameters</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
+<colgroup>
+<col width="150px" class="parameters_name">
+<col class="parameters_description">
+<col width="200px" class="parameters_annotations">
+</colgroup>
+<tbody><tr>
+<td class="parameter_name"><p>widget</p></td>
+<td class="parameter_description"><p>Any <a href="https://developer.gnome.org/gtk3/GtkWidget.html#GtkWidget-struct"><span class="type">GtkWidget</span></a> on the screen.</p></td>
+<td class="parameter_annotations"> </td>
+</tr></tbody>
+</table></div>
+</div>
+</div>
+</div>
+<div class="refsect1">
+<a name="libgimpwidgets-GimpHelpUI.other_details"></a><h2>Types and Values</h2>
+<div class="refsect2">
+<a name="GIMP-HELP-ID:CAPS"></a><h3>GIMP_HELP_ID</h3>
+<pre class="programlisting">#define GIMP_HELP_ID (gimp_help_id_quark ())
+</pre>
+<p>The <span class="type">GQuark</span> used to attach GIMP help IDs to widgets.</p>
+<p class="since">Since: <a class="link" href="api-index-2-2.html#api-index-2.2">2.2</a></p>
+</div>
+</div>
+</div>
+<div class="footer">
+<hr>Generated by GTK-Doc V1.32</div>
+</body>
+</html> \ No newline at end of file