gdk-keyboard-handling.html

来自「最新gtk中文资料集」· HTML 代码 · 共 1,149 行 · 第 1/4 页

on a key is used, and the group determines whether the left or
right symbol is used. On US keyboards, the shift key changes the
keyboard level, and there are no groups. A group switch key might
convert a keyboard between Hebrew to English modes, for example.
<a class="link" href="gdk-Event-Structures.html#GdkEventKey"><span class="type">GdkEventKey</span></a> contains a <code class="literal">group</code> field that indicates the active
keyboard group. The level is computed from the modifier mask.
The returned array should be freed
with <a
href="/usr/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free"
><code class="function">g_free()</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>keymap</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="gdk-Keyboard-Handling.html#GdkKeymap"><span class="type">GdkKeymap</span></a>, or <a
href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"
><code class="literal">NULL</code></a> to use the default keymap
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>keyval</code></em>&#160;:</span></p></td>
<td> a keyval, such as <code class="literal">GDK_a</code>, <code class="literal">GDK_Up</code>, <code class="literal">GDK_Return</code>, etc.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>keys</code></em>&#160;:</span></p></td>
<td> return location for an array of <a class="link" href="gdk-Keyboard-Handling.html#GdkKeymapKey"><span class="type">GdkKeymapKey</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>n_keys</code></em>&#160;:</span></p></td>
<td> return location for number of elements in returned array
</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 keys were found and returned
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3253998"></a><h3>
<a name="gdk-keymap-get-entries-for-keycode"></a>gdk_keymap_get_entries_for_keycode ()</h3>
<a class="indexterm" name="id3254013"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            gdk_keymap_get_entries_for_keycode  (<a class="link" href="gdk-Keyboard-Handling.html#GdkKeymap">GdkKeymap</a> *keymap,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a> hardware_keycode,
                                                         <a class="link" href="gdk-Keyboard-Handling.html#GdkKeymapKey">GdkKeymapKey</a> **keys,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a> **keyvals,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> *n_entries);</pre>
<p>
Returns the keyvals bound to <em class="parameter"><code>hardware_keycode</code></em>.
The Nth <a class="link" href="gdk-Keyboard-Handling.html#GdkKeymapKey"><span class="type">GdkKeymapKey</span></a> in <em class="parameter"><code>keys</code></em> is bound to the Nth
keyval in <em class="parameter"><code>keyvals</code></em>. Free the returned arrays with <a
href="/usr/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free"
><code class="function">g_free()</code></a>.
When a keycode is pressed by the user, the keyval from
this list of entries is selected by considering the effective
keyboard group and level. See <a class="link" href="gdk-Keyboard-Handling.html#gdk-keymap-translate-keyboard-state"><code class="function">gdk_keymap_translate_keyboard_state()</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>keymap</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="gdk-Keyboard-Handling.html#GdkKeymap"><span class="type">GdkKeymap</span></a> or <a
href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"
><code class="literal">NULL</code></a> to use the default keymap
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>hardware_keycode</code></em>&#160;:</span></p></td>
<td> a keycode
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>keys</code></em>&#160;:</span></p></td>
<td> return location for array of <a class="link" href="gdk-Keyboard-Handling.html#GdkKeymapKey"><span class="type">GdkKeymapKey</span></a>, or NULL
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>keyvals</code></em>&#160;:</span></p></td>
<td> return location for array of keyvals, or NULL
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>n_entries</code></em>&#160;:</span></p></td>
<td> length of <em class="parameter"><code>keys</code></em> and <em class="parameter"><code>keyvals</code></em>
</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 there were any entries
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3254261"></a><h3>
<a name="gdk-keymap-get-direction"></a>gdk_keymap_get_direction ()</h3>
<a class="indexterm" name="id3254275"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/pango/pango-Text-Processing.html#PangoDirection"
>PangoDirection</a>      gdk_keymap_get_direction            (<a class="link" href="gdk-Keyboard-Handling.html#GdkKeymap">GdkKeymap</a> *keymap);</pre>
<p>
</p>
<p>
Returns the direction of the keymap. 
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>keymap</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="gdk-Keyboard-Handling.html#GdkKeymap"><span class="type">GdkKeymap</span></a> or <a
href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"
><code class="literal">NULL</code></a> to use the default keymap
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td>the direction of effective layout of the keymap.

<em class="parameter"><code>Returns</code></em>: <a
href="/usr/share/gtk-doc/html/pango/pango-Text-Processing.html#PANGO-DIRECTION-LTR:CAPS"
><code class="literal">PANGO_DIRECTION_LTR</code></a> or <a
href="/usr/share/gtk-doc/html/pango/pango-Text-Processing.html#PANGO-DIRECTION-RTL:CAPS"
><code class="literal">PANGO_DIRECTION_RTL</code></a> 
  if it can determine the direction. <a
href="/usr/share/gtk-doc/html/pango/pango-Text-Processing.html#PANGO-DIRECTION-NEUTRAL:CAPS"
><code class="literal">PANGO_DIRECTION_NEUTRAL</code></a> 
  otherwise.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3254399"></a><h3>
<a name="gdk-keymap-have-bidi-layouts"></a>gdk_keymap_have_bidi_layouts ()</h3>
<a class="indexterm" name="id3254414"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            gdk_keymap_have_bidi_layouts        (<a class="link" href="gdk-Keyboard-Handling.html#GdkKeymap">GdkKeymap</a> *keymap);</pre>
<p>
Determines if keyboard layouts for both right-to-left and left-to-right
languages are in use.</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>keymap</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="gdk-Keyboard-Handling.html#GdkKeymap"><span class="type">GdkKeymap</span></a> or <a
href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"
><code class="literal">NULL</code></a> to use the default keymap
</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 there are layouts in both directions, <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>
<p class="since">Since  2.12
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3254522"></a><h3>
<a name="gdk-keyval-name"></a>gdk_keyval_name ()</h3>
<a class="indexterm" name="id3254535"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a>*              gdk_keyval_name                     (<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a> keyval);</pre>
<p>
Converts a key value into a symbolic name.
The names are the same as those in the <code class="filename">&lt;gdk/gdkkeysyms.h&gt;</code> header file
but without the leading "GDK_".
</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 key value.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td>a string containing the name of the key, or <a
href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"
><code class="literal">NULL</code></a> if <em class="parameter"><code>keyval</code></em> is not
a valid key. The string should not be modified.


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3254618"></a><h3>
<a name="gdk-keyval-from-name"></a>gdk_keyval_from_name ()</h3>
<a class="indexterm" name="id3254632"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a>               gdk_keyval_from_name                (const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *keyval_name);</pre>
<p>
Converts a key name to a key value.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>keyval_name</code></em>&#160;:</span></p></td>
<td>a key name.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td>the corresponding key value, or <code class="literal">GDK_VoidSymbol</code> if the key name is
not a valid key.


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3254702"></a><h3>
<a name="gdk-keyval-convert-case"></a>gdk_keyval_convert_case ()</h3>
<a class="indexterm" name="id3254716"></a><pre class="programlisting">void                gdk_keyval_convert_case             (<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a> symbol,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a> *lower,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a> *upper);</pre>
<p>
Obtains the upper- and lower-case versions of the keyval <em class="parameter"><code>symbol</code></em>.
Examples of keyvals are <span class="type">GDK_a</span>, <span class="type">GDK_Enter</span>, <span class="type">GDK_F1</span>, etc.</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>symbol</code></em>&#160;:</span></p></td>
<td> a keyval
</td>
</tr>