forked from AuroraMiddleware/gtk
f7d593c99d
2001-01-30 Havoc Pennington <hp@pobox.com>
* gtk/gtktreeitem.h, gtk/gtktree.h, gtk/gtktext.h: bracket in
#ifdef GTK_ENABLE_BROKEN.
* gtk/gtktreeitem.c, gtk/gtktree.c, gtk/gtktext.c: #define
GTK_ENABLE_BROKEN just before including the broken headers.
* gtk/gtktypeutils.c: #define GTK_ENABLE_BROKEN, so we can get the
deprecated types registered.
* gtk/testgtk.c, gtk/testselection.c: #define GTK_ENABLE_BROKEN,
we have to test the broken stuff.
* docs/Changes-2.0.txt: explain GTK_ENABLE_BROKEN
2001-01-30 Havoc Pennington <hp@pobox.com>
Also committed a bunch of automatic changes made by gtk-doc,
after reviewing for correctness.
* gtk/tmpl/gtktext.sgml: add warning about deprecation and note
about what to use instead
* gtk/tmpl/gtktree.sgml: ditto
* gtk/Makefile.am (scan): pass --deprecated-guards option to
gtk-doc; requires new version of gtk-doc from CVS
* gtk/gtk-docs.sgml: move GtkText to the deprecated section
instead of the GtkTextView section. Oops.
122 lines
2.8 KiB
Plaintext
122 lines
2.8 KiB
Plaintext
<!-- ##### SECTION Title ##### -->
|
|
Key Values
|
|
|
|
<!-- ##### SECTION Short_Description ##### -->
|
|
functions for manipulating keyboard codes.
|
|
|
|
<!-- ##### SECTION Long_Description ##### -->
|
|
<para>
|
|
Key values are the codes which are sent whenever a key is pressed or released.
|
|
They appear in the <structfield>keyval</structfield> field of the
|
|
#GdkEventKey structure, which is passed to signal handlers for the
|
|
"key-press-event" and "key-release-event" signals.
|
|
The complete list of key values can be found in the <gdk/gdkkeysyms.h>
|
|
header file.
|
|
</para>
|
|
<para>
|
|
Key values can be converted into a string representation using
|
|
gdk_keyval_name(). The reverse function, converting a string to a key value,
|
|
is provided by gdk_keyval_from_name().
|
|
</para>
|
|
<para>
|
|
The case of key values can be determined using gdk_keyval_is_upper() and
|
|
gdk_keyval_is_lower(). Key values can be converted to upper or lower case
|
|
using gdk_keyval_to_upper() and gdk_keyval_to_lower().
|
|
</para>
|
|
|
|
<!-- ##### SECTION See_Also ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
<!-- ##### FUNCTION gdk_keyval_name ##### -->
|
|
<para>
|
|
Converts a key value into a symbolic name.
|
|
The names are the same as those in the <gdk/gdkkeysyms.h> header file
|
|
but without the leading "GDK_".
|
|
</para>
|
|
|
|
@keyval: a key value.
|
|
@Returns: a string containing the name of the key, or NULL if @keyval is not
|
|
a valid key. The string should not be modified.
|
|
|
|
|
|
<!-- ##### FUNCTION gdk_keyval_from_name ##### -->
|
|
<para>
|
|
Converts a key name to a key value.
|
|
</para>
|
|
|
|
@keyval_name: a key name.
|
|
@Returns: the corresponding key value, or %GDK_VoidSymbol if the key name is
|
|
not a valid key.
|
|
|
|
|
|
<!-- ##### FUNCTION gdk_keyval_convert_case ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@symbol:
|
|
@lower:
|
|
@upper:
|
|
|
|
|
|
<!-- ##### FUNCTION gdk_keyval_to_upper ##### -->
|
|
<para>
|
|
Converts a key value to upper case, if applicable.
|
|
</para>
|
|
|
|
@keyval: a key value.
|
|
@Returns: the upper case form of @keyval, or @keyval itself if it is already
|
|
in upper case or it is not subject to case conversion.
|
|
|
|
|
|
<!-- ##### FUNCTION gdk_keyval_to_lower ##### -->
|
|
<para>
|
|
Converts a key value to lower case, if applicable.
|
|
</para>
|
|
|
|
@keyval: a key value.
|
|
@Returns: the lower case form of @keyval, or @keyval itself if it is already
|
|
in lower case or it is not subject to case conversion.
|
|
|
|
|
|
<!-- ##### FUNCTION gdk_keyval_is_upper ##### -->
|
|
<para>
|
|
Returns TRUE if the given key value is in upper case.
|
|
</para>
|
|
|
|
@keyval: a key value.
|
|
@Returns: TRUE if @keyval is in upper case, or if @keyval is not subject to
|
|
case conversion.
|
|
|
|
|
|
<!-- ##### FUNCTION gdk_keyval_is_lower ##### -->
|
|
<para>
|
|
Returns TRUE if the given key value is in lower case.
|
|
</para>
|
|
|
|
@keyval: a key value.
|
|
@Returns: TRUE if @keyval is in lower case, or if @keyval is not subject to
|
|
case conversion.
|
|
|
|
|
|
<!-- ##### FUNCTION gdk_keyval_to_unicode ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@keyval:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gdk_unicode_to_keyval ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@wc:
|
|
@Returns:
|
|
|
|
|