gtk-keyboard-accelerators.html

最新gtk中文资料集

</p>
<p>
Note that <em class="firstterm">accelerators</em> are different from
<em class="firstterm">mnemonics</em>. Accelerators are shortcuts for
activating a menu item; they appear alongside the menu item they're a
shortcut for. For example "Ctrl+Q" might appear alongside the "Quit"
menu item. Mnemonics are shortcuts for GUI elements such as text
entries or buttons; they appear as underlined characters. See
<a class="link" href="GtkLabel.html#gtk-label-new-with-mnemonic"><code class="function">gtk_label_new_with_mnemonic()</code></a>. Menu items can have both accelerators
and mnemonics, of course.
</p>
</div>
<div class="refsect1" lang="en">
<a name="id3157582"></a><h2>Details</h2>
<div class="refsect2" lang="en">
<a name="id3157592"></a><h3>
<a name="GtkAccelGroup-struct"></a>GtkAccelGroup</h3>
<a class="indexterm" name="id3157605"></a><pre class="programlisting">typedef struct _GtkAccelGroup GtkAccelGroup;</pre>
<p>
An object representing and maintaining a group of accelerators.
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3157621"></a><h3>
<a name="gtk-accel-group-new"></a>gtk_accel_group_new ()</h3>
<a class="indexterm" name="id3157634"></a><pre class="programlisting"><a class="link" href="gtk-Keyboard-Accelerators.html#GtkAccelGroup">GtkAccelGroup</a>*      gtk_accel_group_new                 (void);</pre>
<p>
Creates a new <a class="link" href="gtk-Keyboard-Accelerators.html#GtkAccelGroup"><span class="type">GtkAccelGroup</span></a>.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> a new <a class="link" href="gtk-Keyboard-Accelerators.html#GtkAccelGroup"><span class="type">GtkAccelGroup</span></a> object
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3157690"></a><h3>
<a name="gtk-accel-group-ref"></a>gtk_accel_group_ref</h3>
<a class="indexterm" name="id3157705"></a><pre class="programlisting">#define	gtk_accel_group_ref	g_object_ref
</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_accel_group_ref</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Deprecated equivalent of <a
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#g-object-ref"
><code class="function">g_object_ref()</code></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td>the accel group that was passed in


</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3157759"></a><h3>
<a name="gtk-accel-group-unref"></a>gtk_accel_group_unref</h3>
<a class="indexterm" name="id3157774"></a><pre class="programlisting">#define	gtk_accel_group_unref	g_object_unref
</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_accel_group_unref</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Deprecated equivalent of <a
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#g-object-unref"
><code class="function">g_object_unref()</code></a>.
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3157813"></a><h3>
<a name="gtk-accel-group-connect"></a>gtk_accel_group_connect ()</h3>
<a class="indexterm" name="id3157826"></a><pre class="programlisting">void                gtk_accel_group_connect             (<a class="link" href="gtk-Keyboard-Accelerators.html#GtkAccelGroup">GtkAccelGroup</a> *accel_group,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a> accel_key,
                                                         <a
href="/usr/share/gtk-doc/html/gdk/gdk-Windows.html#GdkModifierType"
>GdkModifierType</a> accel_mods,
                                                         <a class="link" href="gtk-Standard-Enumerations.html#GtkAccelFlags">GtkAccelFlags</a> accel_flags,
                                                         <a
href="/usr/share/gtk-doc/html/gobject/gobject-Closures.html#GClosure"
>GClosure</a> *closure);</pre>
<p>
Installs an accelerator in this group. When <em class="parameter"><code>accel_group</code></em> is being activated
in response to a call to <a class="link" href="gtk-Keyboard-Accelerators.html#gtk-accel-groups-activate"><code class="function">gtk_accel_groups_activate()</code></a>, <em class="parameter"><code>closure</code></em> will be
invoked if the <em class="parameter"><code>accel_key</code></em> and <em class="parameter"><code>accel_mods</code></em> from <a class="link" href="gtk-Keyboard-Accelerators.html#gtk-accel-groups-activate"><code class="function">gtk_accel_groups_activate()</code></a>
match those of this connection.
</p>
<p>
The signature used for the <em class="parameter"><code>closure</code></em> is that of <a class="link" href="gtk-Keyboard-Accelerators.html#GtkAccelGroupActivate"><span class="type">GtkAccelGroupActivate</span></a>.
</p>
<p>
Note that, due to implementation details, a single closure can only be
connected to one accelerator group.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>accel_group</code></em>&#160;:</span></p></td>
<td>      the accelerator group to install an accelerator in
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>accel_key</code></em>&#160;:</span></p></td>
<td>        key value of the accelerator
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>accel_mods</code></em>&#160;:</span></p></td>
<td>       modifier combination of the accelerator
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>accel_flags</code></em>&#160;:</span></p></td>
<td>      a flag mask to configure this accelerator
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>closure</code></em>&#160;:</span></p></td>
<td>          closure to be executed upon accelerator activation
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3158039"></a><h3>
<a name="gtk-accel-group-connect-by-path"></a>gtk_accel_group_connect_by_path ()</h3>
<a class="indexterm" name="id3158052"></a><pre class="programlisting">void                gtk_accel_group_connect_by_path     (<a class="link" href="gtk-Keyboard-Accelerators.html#GtkAccelGroup">GtkAccelGroup</a> *accel_group,
                                                         const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *accel_path,
                                                         <a
href="/usr/share/gtk-doc/html/gobject/gobject-Closures.html#GClosure"
>GClosure</a> *closure);</pre>
<p>
Installs an accelerator in this group, using an accelerator path to look
up the appropriate key and modifiers (see <a class="link" href="gtk-Accelerator-Maps.html#gtk-accel-map-add-entry"><code class="function">gtk_accel_map_add_entry()</code></a>).
When <em class="parameter"><code>accel_group</code></em> is being activated in response to a call to
<a class="link" href="gtk-Keyboard-Accelerators.html#gtk-accel-groups-activate"><code class="function">gtk_accel_groups_activate()</code></a>, <em class="parameter"><code>closure</code></em> will be invoked if the <em class="parameter"><code>accel_key</code></em> and
<em class="parameter"><code>accel_mods</code></em> from <a class="link" href="gtk-Keyboard-Accelerators.html#gtk-accel-groups-activate"><code class="function">gtk_accel_groups_activate()</code></a> match the key and modifiers
for the path.
</p>
<p>
The signature used for the <em class="parameter"><code>closure</code></em> is that of <a class="link" href="gtk-Keyboard-Accelerators.html#GtkAccelGroupActivate"><span class="type">GtkAccelGroupActivate</span></a>.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>accel_group</code></em>&#160;:</span></p></td>
<td>      the accelerator group to install an accelerator in
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>accel_path</code></em>&#160;:</span></p></td>
<td>       path used for determining key and modifiers.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>closure</code></em>&#160;:</span></p></td>
<td>          closure to be executed upon accelerator activation
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3158229"></a><h3>
<a name="GtkAccelGroupActivate"></a>GtkAccelGroupActivate ()</h3>
<a class="indexterm" name="id3158243"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            (*GtkAccelGroupActivate)            (<a class="link" href="gtk-Keyboard-Accelerators.html#GtkAccelGroup">GtkAccelGroup</a> *accel_group,
                                                         <a
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
>GObject</a> *acceleratable,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a> keyval,
                                                         <a
href="/usr/share/gtk-doc/html/gdk/gdk-Windows.html#GdkModifierType"
>GdkModifierType</a> modifier);</pre>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>accel_group</code></em>&#160;:</span></p></td>
<td>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>acceleratable</code></em>&#160;:</span></p></td>
<td>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>keyval</code></em>&#160;:</span></p></td>
<td>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>modifier</code></em>&#160;:</span></p></td>
<td>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td>


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3158364"></a><h3>
<a name="GtkAccelGroupFindFunc"></a>GtkAccelGroupFindFunc ()</h3>
<a class="indexterm" name="id3158380"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            (*GtkAccelGroupFindFunc)            (<a class="link" href="gtk-Keyboard-Accelerators.html#GtkAccelKey">GtkAccelKey</a> *key,
                                                         <a
href="/usr/share/gtk-doc/html/gobject/gobject-Closures.html#GClosure"
>GClosure</a> *closure,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> data);</pre>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>key</code></em>&#160;:</span></p></td>
<td>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>closure</code></em>&#160;:</span></p></td>
<td>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>data</code></em>&#160;:</span></p></td>
<td>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td>