gtk-keyboard-accelerators.html

最新gtk中文资料集

<p>
If you need to display accelerators in the user interface,
see <a class="link" href="gtk-Keyboard-Accelerators.html#gtk-accelerator-get-label"><code class="function">gtk_accelerator_get_label()</code></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>accelerator_key</code></em>&#160;:</span></p></td>
<td>  accelerator keyval
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>accelerator_mods</code></em>&#160;:</span></p></td>
<td> accelerator modifier mask
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> a newly-allocated accelerator name
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3160351"></a><h3>
<a name="gtk-accelerator-get-label"></a>gtk_accelerator_get_label ()</h3>
<a class="indexterm" name="id3160367"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a>*              gtk_accelerator_get_label           (<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 
which can be used to represent the accelerator to the user.</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_key</code></em>&#160;:</span></p></td>
<td>  accelerator keyval
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>accelerator_mods</code></em>&#160;:</span></p></td>
<td> accelerator modifier mask
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> a newly-allocated string representing the accelerator.

</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.6
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3160459"></a><h3>
<a name="gtk-accelerator-set-default-mod-mask"></a>gtk_accelerator_set_default_mod_mask ()</h3>
<a class="indexterm" name="id3160473"></a><pre class="programlisting">void                gtk_accelerator_set_default_mod_mask
                                                        (<a
href="/usr/share/gtk-doc/html/gdk/gdk-Windows.html#GdkModifierType"
>GdkModifierType</a> default_mod_mask);</pre>
<p>
Sets the modifiers that will be considered significant for keyboard
accelerators. The default mod mask is <a
href="/usr/share/gtk-doc/html/gdk/gdk-Windows.html#GDK-CONTROL-MASK:CAPS"
><span class="type">GDK_CONTROL_MASK</span></a> |
<a
href="/usr/share/gtk-doc/html/gdk/gdk-Windows.html#GDK-SHIFT-MASK:CAPS"
><span class="type">GDK_SHIFT_MASK</span></a> | <a
href="/usr/share/gtk-doc/html/gdk/gdk-Windows.html#GDK-MOD1-MASK:CAPS"
><span class="type">GDK_MOD1_MASK</span></a> | <a
href="/usr/share/gtk-doc/html/gdk/gdk-Windows.html#GDK-SUPER-MASK:CAPS"
><span class="type">GDK_SUPER_MASK</span></a> | 
<a
href="/usr/share/gtk-doc/html/gdk/gdk-Windows.html#GDK-HYPER-MASK:CAPS"
><span class="type">GDK_HYPER_MASK</span></a> | <a
href="/usr/share/gtk-doc/html/gdk/gdk-Windows.html#GDK-META-MASK:CAPS"
><span class="type">GDK_META_MASK</span></a>, that is, Control, Shift, Alt, 
Super, Hyper and Meta. Other modifiers will by default be ignored 
by <a class="link" href="gtk-Keyboard-Accelerators.html#GtkAccelGroup"><span class="type">GtkAccelGroup</span></a>.
You must include at least the three modifiers Control, Shift
and Alt in any value you pass to this function.
</p>
<p>
The default mod mask should be changed on application startup,
before using any accelerator groups.</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>default_mod_mask</code></em>&#160;:</span></p></td>
<td> accelerator modifier mask
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3160598"></a><h3>
<a name="gtk-accelerator-get-default-mod-mask"></a>gtk_accelerator_get_default_mod_mask ()</h3>
<a class="indexterm" name="id3160612"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a>               gtk_accelerator_get_default_mod_mask
                                                        (void);</pre>
<p>
Gets the value set by <a class="link" href="gtk-Keyboard-Accelerators.html#gtk-accelerator-set-default-mod-mask"><code class="function">gtk_accelerator_set_default_mod_mask()</code></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> the default accelerator modifier mask
</td>
</tr></tbody>
</table></div>
</div>
</div>
<div class="refsect1" lang="en">
<a name="id3160666"></a><h2>Signal Details</h2>
<div class="refsect2" lang="en">
<a name="id3160677"></a><h3>
<a name="GtkAccelGroup-accel-activate"></a>The <code class="literal">"accel-activate"</code> signal</h3>
<a class="indexterm" name="id3160693"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            user_function                      (<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,
                                                        <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a>        user_data)          : Has Details</pre>
<p>
The accel-activate signal is an implementation detail of
<a class="link" href="gtk-Keyboard-Accelerators.html#GtkAccelGroup"><span class="type">GtkAccelGroup</span></a> and not meant to be used by applications.</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 <a class="link" href="gtk-Keyboard-Accelerators.html#GtkAccelGroup"><span class="type">GtkAccelGroup</span></a> which received the signal
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>acceleratable</code></em>&#160;:</span></p></td>
<td> the object on which the accelerator was activated
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>keyval</code></em>&#160;:</span></p></td>
<td> the accelerator keyval
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>modifier</code></em>&#160;:</span></p></td>
<td> the modifier combination of the accelerator
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>user_data</code></em>&#160;:</span></p></td>
<td>user data set when the signal handler was connected.</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 activated
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3160871"></a><h3>
<a name="GtkAccelGroup-accel-changed"></a>The <code class="literal">"accel-changed"</code> signal</h3>
<a class="indexterm" name="id3160888"></a><pre class="programlisting">void                user_function                      (<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>           keyval,
                                                        <a
href="/usr/share/gtk-doc/html/gdk/gdk-Windows.html#GdkModifierType"
>GdkModifierType</a> modifier,
                                                        <a
href="/usr/share/gtk-doc/html/gobject/gobject-Closures.html#GClosure"
>GClosure</a>       *accel_closure,
                                                        <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a>        user_data)          : Run First / Has Details</pre>
<p>
The accel-changed signal is emitted when a <span class="type">GtkAccelGroupEntry</span>
is added to or removed from the accel group. 
</p>
<p>
Widgets like <a class="link" href="GtkAccelLabel.html" title="GtkAccelLabel"><span class="type">GtkAccelLabel</span></a> which display an associated 
accelerator should connect to this signal, and rebuild 
their visual representation if the <em class="parameter"><code>accel_closure</code></em> is theirs.</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 <a class="link" href="gtk-Keyboard-Accelerators.html#GtkAccelGroup"><span class="type">GtkAccelGroup</span></a> which received the signal
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>keyval</code></em>&#160;:</span></p></td>
<td> the accelerator keyval
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>modifier</code></em>&#160;:</span></p></td>
<td> the modifier combination of the accelerator
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>accel_closure</code></em>&#160;:</span></p></td>
<td> the <a
href="/usr/share/gtk-doc/html/gobject/gobject-Closures.html#GClosure"
><span class="type">GClosure</span></a> of the accelerator
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>user_data</code></em>&#160;:</span></p></td>
<td>user data set when the signal handler was connected.</td>
</tr>
</tbody>
</table></div>
</div>
</div>
<div class="refsect1" lang="en">
<a name="id3161076"></a><h2>See Also</h2>
<p>
<a class="link" href="GtkWindow.html#gtk-window-add-accel-group"><code class="function">gtk_window_add_accel_group()</code></a>, <a class="link" href="gtk-Accelerator-Maps.html#gtk-accel-map-change-entry"><code class="function">gtk_accel_map_change_entry()</code></a>,
<a class="link" href="GtkItemFactory.html#gtk-item-factory-new"><code class="function">gtk_item_factory_new()</code></a>, <a class="link" href="GtkLabel.html#gtk-label-new-with-mnemonic"><code class="function">gtk_label_new_with_mnemonic()</code></a>
</p>
</div>
<div class="refsect1" lang="en">
<a name="id3161132"></a><div class="refsect2" lang="en"><a name="id3161133"></a></div>
<hr>
<div class="refsect2" lang="en"><a name="id3161134"></a></div>
</div>
</div>
</body>
</html>