glib-hook-functions.html

最新gtk中文资料集

<a class="indexterm" name="id3056566"></a><pre class="programlisting">void                (*GHookFinalizeFunc)                (<a class="link" href="glib-Hook-Functions.html#GHookList">GHookList</a> *hook_list,
                                                         <a class="link" href="glib-Hook-Functions.html#GHook">GHook</a> *hook);</pre>
<p>
Defines the type of function to be called when a hook in a 
list of hooks gets finalized.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>hook_list</code></em>&#160;:</span></p></td>
<td>a <a class="link" href="glib-Hook-Functions.html#GHookList"><span class="type">GHookList</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>hook</code></em>&#160;:</span></p></td>
<td>the hook in <em class="parameter"><code>hook_list</code></em> that gets finalized


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3056649"></a><h3>
<a name="GHook"></a>GHook</h3>
<a class="indexterm" name="id3056662"></a><pre class="programlisting">typedef struct {
  gpointer	 data;
  GHook		*next;
  GHook		*prev;
  guint		 ref_count;
  gulong	 hook_id;
  guint		 flags;
  gpointer	 func;
  GDestroyNotify destroy;
} GHook;
</pre>
<p>
The <span class="structname">GHook</span> struct represents a single hook 
function in a <a class="link" href="glib-Hook-Functions.html#GHookList"><span class="type">GHookList</span></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><a class="link" href="glib-Basic-Types.html#gpointer">gpointer</a>&#160;<em class="structfield"><code>data</code></em>;</span></p></td>
<td>data which is passed to func when this hook is invoked
</td>
</tr>
<tr>
<td><p><span class="term"><a class="link" href="glib-Hook-Functions.html#GHook">GHook</a>&#160;*<em class="structfield"><code>next</code></em>;</span></p></td>
<td>pointer to the next hook in the list
</td>
</tr>
<tr>
<td><p><span class="term"><a class="link" href="glib-Hook-Functions.html#GHook">GHook</a>&#160;*<em class="structfield"><code>prev</code></em>;</span></p></td>
<td>pointer to the previous hook in the list
</td>
</tr>
<tr>
<td><p><span class="term"><a class="link" href="glib-Basic-Types.html#guint">guint</a>&#160;<em class="structfield"><code>ref_count</code></em>;</span></p></td>
<td>the reference count of this hook
</td>
</tr>
<tr>
<td><p><span class="term"><a class="link" href="glib-Basic-Types.html#gulong">gulong</a>&#160;<em class="structfield"><code>hook_id</code></em>;</span></p></td>
<td>the id of this hook, which is unique within its list
</td>
</tr>
<tr>
<td><p><span class="term"><a class="link" href="glib-Basic-Types.html#guint">guint</a>&#160;<em class="structfield"><code>flags</code></em>;</span></p></td>
<td>flags which are set for this hook. See <a class="link" href="glib-Hook-Functions.html#GHookFlagMask"><span class="type">GHookFlagMask</span></a> for
    predefined flags
</td>
</tr>
<tr>
<td><p><span class="term"><a class="link" href="glib-Basic-Types.html#gpointer">gpointer</a>&#160;<em class="structfield"><code>func</code></em>;</span></p></td>
<td>the function to call when this hook is invoked. The possible 
signatures for this function are <a class="link" href="glib-Hook-Functions.html#GHookFunc"><span class="type">GHookFunc</span></a> and <a class="link" href="glib-Hook-Functions.html#GHookCheckFunc"><span class="type">GHookCheckFunc</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><a class="link" href="glib-Datasets.html#GDestroyNotify">GDestroyNotify</a>&#160;<em class="structfield"><code>destroy</code></em>;</span></p></td>
<td>the default <code class="function">finalize_hook</code> function of a 
<a class="link" href="glib-Hook-Functions.html#GHookList"><span class="type">GHookList</span></a> calls this member of the hook that is being finalized

</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3056904"></a><h3>
<a name="GHookFunc"></a>GHookFunc ()</h3>
<a class="indexterm" name="id3056916"></a><pre class="programlisting">void                (*GHookFunc)                        (<a class="link" href="glib-Basic-Types.html#gpointer">gpointer</a> data);</pre>
<p>
Defines the type of a hook function that can be invoked
by <a class="link" href="glib-Hook-Functions.html#g-hook-list-invoke"><code class="function">g_hook_list_invoke()</code></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><em class="parameter"><code>data</code></em>&#160;:</span></p></td>
<td>the data field of the <a class="link" href="glib-Hook-Functions.html#GHook"><span class="type">GHook</span></a> is passed to the hook function here


</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3056983"></a><h3>
<a name="GHookCheckFunc"></a>GHookCheckFunc ()</h3>
<a class="indexterm" name="id3056995"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a>            (*GHookCheckFunc)                   (<a class="link" href="glib-Basic-Types.html#gpointer">gpointer</a> data);</pre>
<p>
Defines the type of a hook function that can be invoked
by <a class="link" href="glib-Hook-Functions.html#g-hook-list-invoke-check"><code class="function">g_hook_list_invoke_check()</code></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>data</code></em>&#160;:</span></p></td>
<td>the data field of the <a class="link" href="glib-Hook-Functions.html#GHook"><span class="type">GHook</span></a> is passed to the hook function here
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td>
<a class="link" href="glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if the <a class="link" href="glib-Hook-Functions.html#GHook"><span class="type">GHook</span></a> should be destroyed


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3057090"></a><h3>
<a name="g-hook-list-init"></a>g_hook_list_init ()</h3>
<a class="indexterm" name="id3057102"></a><pre class="programlisting">void                g_hook_list_init                    (<a class="link" href="glib-Hook-Functions.html#GHookList">GHookList</a> *hook_list,
                                                         <a class="link" href="glib-Basic-Types.html#guint">guint</a> hook_size);</pre>
<p>
Initializes a <a class="link" href="glib-Hook-Functions.html#GHookList"><span class="type">GHookList</span></a>.
This must be called before the <a class="link" href="glib-Hook-Functions.html#GHookList"><span class="type">GHookList</span></a> is used.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>hook_list</code></em>&#160;:</span></p></td>
<td>a <a class="link" href="glib-Hook-Functions.html#GHookList"><span class="type">GHookList</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>hook_size</code></em>&#160;:</span></p></td>
<td>the size of each element in the <a class="link" href="glib-Hook-Functions.html#GHookList"><span class="type">GHookList</span></a>, typically
    <code class="literal">sizeof (GHook)</code>


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3057209"></a><h3>
<a name="g-hook-list-invoke"></a>g_hook_list_invoke ()</h3>
<a class="indexterm" name="id3057222"></a><pre class="programlisting">void                g_hook_list_invoke                  (<a class="link" href="glib-Hook-Functions.html#GHookList">GHookList</a> *hook_list,
                                                         <a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a> may_recurse);</pre>
<p>
Calls all of the <a class="link" href="glib-Hook-Functions.html#GHook"><span class="type">GHook</span></a> functions in a <a class="link" href="glib-Hook-Functions.html#GHookList"><span class="type">GHookList</span></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>hook_list</code></em>&#160;:</span></p></td>
<td>a <a class="link" href="glib-Hook-Functions.html#GHookList"><span class="type">GHookList</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>may_recurse</code></em>&#160;:</span></p></td>
<td>
<a class="link" href="glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if functions which are already running (e.g. in another
    thread) can be called. If set to <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>, these are skipped


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3057335"></a><h3>
<a name="g-hook-list-invoke-check"></a>g_hook_list_invoke_check ()</h3>
<a class="indexterm" name="id3057348"></a><pre class="programlisting">void                g_hook_list_invoke_check            (<a class="link" href="glib-Hook-Functions.html#GHookList">GHookList</a> *hook_list,
                                                         <a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a> may_recurse);</pre>
<p>
Calls all of the <a class="link" href="glib-Hook-Functions.html#GHook"><span class="type">GHook</span></a> functions in a <a class="link" href="glib-Hook-Functions.html#GHookList"><span class="type">GHookList</span></a>.
Any function which returns <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> is removed from the <a class="link" href="glib-Hook-Functions.html#GHookList"><span class="type">GHookList</span></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>hook_list</code></em>&#160;:</span></p></td>
<td>a <a class="link" href="glib-Hook-Functions.html#GHookList"><span class="type">GHookList</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>may_recurse</code></em>&#160;:</span></p></td>
<td>
<a class="link" href="glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if functions which are already running (e.g. in another
thread) can be called. If set to <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>, these are skipped