gtk-keyboard-accelerators.html

最新gtk中文资料集

<td><p><span class="term"><em class="parameter"><code>closure</code></em>&#160;:</span></p></td>
<td> a <a
href="/usr/share/gtk-doc/html/gobject/gobject-Closures.html#GClosure"
><span class="type">GClosure</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> the <a class="link" href="gtk-Keyboard-Accelerators.html#GtkAccelGroup"><span class="type">GtkAccelGroup</span></a> to which <em class="parameter"><code>closure</code></em> is connected, or <a
href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"
><code class="literal">NULL</code></a>.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3159438"></a><h3>
<a name="gtk-accel-groups-activate"></a>gtk_accel_groups_activate ()</h3>
<a class="indexterm" name="id3159452"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            gtk_accel_groups_activate           (<a
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
>GObject</a> *object,
                                                         <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);</pre>
<p>
Finds the first accelerator in any <a class="link" href="gtk-Keyboard-Accelerators.html#GtkAccelGroup"><span class="type">GtkAccelGroup</span></a> attached
to <em class="parameter"><code>object</code></em> that matches <em class="parameter"><code>accel_key</code></em> and <em class="parameter"><code>accel_mods</code></em>, and
activates that accelerator.
If an accelerator was activated and handled this keypress, <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a>
is returned.</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>object</code></em>&#160;:</span></p></td>
<td>        the <a
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
><span class="type">GObject</span></a>, usually a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a>, on which
                to activate the accelerator.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>accel_key</code></em>&#160;:</span></p></td>
<td>     accelerator keyval from a key event
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>accel_mods</code></em>&#160;:</span></p></td>
<td>    keyboard state mask from a key event
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td>       <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a> if the accelerator was handled, <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"
><code class="literal">FALSE</code></a> otherwise
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3159633"></a><h3>
<a name="gtk-accel-groups-from-object"></a>gtk_accel_groups_from_object ()</h3>
<a class="indexterm" name="id3159646"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Singly-Linked-Lists.html#GSList"
>GSList</a>*             gtk_accel_groups_from_object        (<a
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
>GObject</a> *object);</pre>
<p>
Gets a list of all accel groups which are attached to <em class="parameter"><code>object</code></em>.</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>object</code></em>&#160;:</span></p></td>
<td>        a <a
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
><span class="type">GObject</span></a>, usually a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> 
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> a list of all accel groups which are attached to <em class="parameter"><code>object</code></em>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3159736"></a><h3>
<a name="gtk-accel-group-find"></a>gtk_accel_group_find ()</h3>
<a class="indexterm" name="id3159748"></a><pre class="programlisting"><a class="link" href="gtk-Keyboard-Accelerators.html#GtkAccelKey">GtkAccelKey</a>*        gtk_accel_group_find                (<a class="link" href="gtk-Keyboard-Accelerators.html#GtkAccelGroup">GtkAccelGroup</a> *accel_group,
                                                         <a class="link" href="gtk-Keyboard-Accelerators.html#GtkAccelGroupFindFunc">GtkAccelGroupFindFunc</a> find_func,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> data);</pre>
<p>
Finds the first entry in an accelerator group for which 
<em class="parameter"><code>find_func</code></em> returns <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a> and returns its <a class="link" href="gtk-Keyboard-Accelerators.html#GtkAccelKey"><span class="type">GtkAccelKey</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> a <a class="link" href="gtk-Keyboard-Accelerators.html#GtkAccelGroup"><span class="type">GtkAccelGroup</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>find_func</code></em>&#160;:</span></p></td>
<td> a function to filter the entries of <em class="parameter"><code>accel_group</code></em> with
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>data</code></em>&#160;:</span></p></td>
<td> data to pass to <em class="parameter"><code>find_func</code></em>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> the key of the first entry passing <em class="parameter"><code>find_func</code></em>. The key is 
owned by GTK+ and must not be freed.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3159906"></a><h3>
<a name="GtkAccelKey"></a>GtkAccelKey</h3>
<a class="indexterm" name="id3159918"></a><pre class="programlisting">typedef struct {
  guint           accel_key;
  GdkModifierType accel_mods;
  guint           accel_flags : 16;
} GtkAccelKey;
</pre>
<p>

</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3159935"></a><h3>
<a name="gtk-accelerator-valid"></a>gtk_accelerator_valid ()</h3>
<a class="indexterm" name="id3159948"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            gtk_accelerator_valid               (<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> modifiers);</pre>
<p>
Determines whether a given keyval and modifier mask constitute
a valid keyboard accelerator. For example, the <span class="type">GDK_a</span> keyval
plus <a
href="/usr/share/gtk-doc/html/gdk/gdk-Windows.html#GDK-CONTROL-MASK:CAPS"
><span class="type">GDK_CONTROL_MASK</span></a> is valid - this is a "Ctrl+a" accelerator.
But, you can't, for instance, use the <span class="type">GDK_Control_L</span> keyval
as an accelerator.</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>keyval</code></em>&#160;:</span></p></td>
<td>    a GDK keyval
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>modifiers</code></em>&#160;:</span></p></td>
<td> modifier mask
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td>   <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a> if the accelerator is valid
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3160073"></a><h3>
<a name="gtk-accelerator-parse"></a>gtk_accelerator_parse ()</h3>
<a class="indexterm" name="id3160086"></a><pre class="programlisting">void                gtk_accelerator_parse               (const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *accelerator,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a> *accelerator_key,
                                                         <a
href="/usr/share/gtk-doc/html/gdk/gdk-Windows.html#GdkModifierType"
>GdkModifierType</a> *accelerator_mods);</pre>
<p>
Parses a string representing an accelerator. The
format looks like "&lt;Control&gt;a" or "&lt;Shift&gt;&lt;Alt&gt;F1" or
"&lt;Release&gt;z" (the last one is for key release).
The parser is fairly liberal and allows lower or upper case,
and also abbreviations such as "&lt;Ctl&gt;" and "&lt;Ctrl&gt;".
</p>
<p>
If the parse fails, <em class="parameter"><code>accelerator_key</code></em> and <em class="parameter"><code>accelerator_mods</code></em> will
be set to 0 (zero).</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>accelerator</code></em>&#160;:</span></p></td>
<td>      string representing an accelerator
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>accelerator_key</code></em>&#160;:</span></p></td>
<td>  return location for accelerator keyval
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>accelerator_mods</code></em>&#160;:</span></p></td>
<td> return location for accelerator modifier mask
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3160208"></a><h3>
<a name="gtk-accelerator-name"></a>gtk_accelerator_name ()</h3>
<a class="indexterm" name="id3160220"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a>*              gtk_accelerator_name                (<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a> accelerator_key,
                                                         <a
href="/usr/share/gtk-doc/html/gdk/gdk-Windows.html#GdkModifierType"
>GdkModifierType</a> accelerator_mods);</pre>
<p>
Converts an accelerator keyval and modifier mask
into a string parseable by <a class="link" href="gtk-Keyboard-Accelerators.html#gtk-accelerator-parse"><code class="function">gtk_accelerator_parse()</code></a>.
For example, if you pass in <span class="type">GDK_q</span> and <a
href="/usr/share/gtk-doc/html/gdk/gdk-Windows.html#GDK-CONTROL-MASK:CAPS"
><span class="type">GDK_CONTROL_MASK</span></a>,
this function returns "&lt;Control&gt;q". 
</p>