diff options
author | Leo Tenenbaum <pommicket@gmail.com> | 2018-08-20 21:12:06 -0400 |
---|---|---|
committer | Leo Tenenbaum <pommicket@gmail.com> | 2018-08-20 21:12:06 -0400 |
commit | 63e87c2d0c9d263f14c77b68f85c67d46ece82a9 (patch) | |
tree | 6260365cbf7d24f37d27669e8538227fcb72e243 /gtk+-mingw/share/gtk-doc/html/gtk3/gtk3-Bindings.html | |
parent | a4460f6d9453bbd7e584937686449cef3e19f052 (diff) |
Diffstat (limited to 'gtk+-mingw/share/gtk-doc/html/gtk3/gtk3-Bindings.html')
-rw-r--r-- | gtk+-mingw/share/gtk-doc/html/gtk3/gtk3-Bindings.html | 872 |
1 files changed, 0 insertions, 872 deletions
diff --git a/gtk+-mingw/share/gtk-doc/html/gtk3/gtk3-Bindings.html b/gtk+-mingw/share/gtk-doc/html/gtk3/gtk3-Bindings.html deleted file mode 100644 index 6fd363d..0000000 --- a/gtk+-mingw/share/gtk-doc/html/gtk3/gtk3-Bindings.html +++ /dev/null @@ -1,872 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> -<html> -<head> -<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> -<title>Bindings</title> -<meta name="generator" content="DocBook XSL Stylesheets V1.76.1"> -<link rel="home" href="index.html" title="GTK+ 3 Reference Manual"> -<link rel="up" href="gtkbase.html" title="Part II. GTK+ Core Reference"> -<link rel="prev" href="GtkSettings.html" title="Settings"> -<link rel="next" href="gtk3-Standard-Enumerations.html" title="Standard Enumerations"> -<meta name="generator" content="GTK-Doc V1.18.1 (XML mode)"> -<link rel="stylesheet" href="style.css" type="text/css"> -</head> -<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"> -<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"> -<tr valign="middle"> -<td><a accesskey="p" href="GtkSettings.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td> -<td><a accesskey="u" href="gtkbase.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td> -<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td> -<th width="100%" align="center">GTK+ 3 Reference Manual</th> -<td><a accesskey="n" href="gtk3-Standard-Enumerations.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td> -</tr> -<tr><td colspan="5" class="shortcuts"> -<a href="#gtk3-Bindings.synopsis" class="shortcut">Top</a> - | - <a href="#gtk3-Bindings.description" class="shortcut">Description</a> -</td></tr> -</table> -<div class="refentry"> -<a name="gtk3-Bindings"></a><div class="titlepage"></div> -<div class="refnamediv"><table width="100%"><tr> -<td valign="top"> -<h2><span class="refentrytitle"><a name="gtk3-Bindings.top_of_page"></a>Bindings</span></h2> -<p>Bindings — Key bindings for individual widgets</p> -</td> -<td valign="top" align="right"></td> -</tr></table></div> -<div class="refsynopsisdiv"> -<a name="gtk3-Bindings.synopsis"></a><h2>Synopsis</h2> -<pre class="synopsis"> -#include <gtk/gtk.h> - -struct <a class="link" href="gtk3-Bindings.html#GtkBindingSet" title="struct GtkBindingSet">GtkBindingSet</a>; -struct <a class="link" href="gtk3-Bindings.html#GtkBindingEntry" title="struct GtkBindingEntry">GtkBindingEntry</a>; -struct <a class="link" href="gtk3-Bindings.html#GtkBindingSignal" title="struct GtkBindingSignal">GtkBindingSignal</a>; -struct <a class="link" href="gtk3-Bindings.html#GtkBindingArg" title="struct GtkBindingArg">GtkBindingArg</a>; -<span class="returnvalue">void</span> <a class="link" href="gtk3-Bindings.html#gtk-binding-entry-add-signall" title="gtk_binding_entry_add_signall ()">gtk_binding_entry_add_signall</a> (<em class="parameter"><code><a class="link" href="gtk3-Bindings.html#GtkBindingSet" title="struct GtkBindingSet"><span class="type">GtkBindingSet</span></a> *binding_set</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> keyval</code></em>, - <em class="parameter"><code><a href="http://developer.gnome.org/gdk/gdk3-Windows.html#GdkModifierType"><span class="type">GdkModifierType</span></a> modifiers</code></em>, - <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *signal_name</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a> *binding_args</code></em>); -<a class="link" href="gtk3-Bindings.html#GtkBindingSet" title="struct GtkBindingSet"><span class="returnvalue">GtkBindingSet</span></a> * <a class="link" href="gtk3-Bindings.html#gtk-binding-set-new" title="gtk_binding_set_new ()">gtk_binding_set_new</a> (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *set_name</code></em>); -<a class="link" href="gtk3-Bindings.html#GtkBindingSet" title="struct GtkBindingSet"><span class="returnvalue">GtkBindingSet</span></a> * <a class="link" href="gtk3-Bindings.html#gtk-binding-set-by-class" title="gtk_binding_set_by_class ()">gtk_binding_set_by_class</a> (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> object_class</code></em>); -<a class="link" href="gtk3-Bindings.html#GtkBindingSet" title="struct GtkBindingSet"><span class="returnvalue">GtkBindingSet</span></a> * <a class="link" href="gtk3-Bindings.html#gtk-binding-set-find" title="gtk_binding_set_find ()">gtk_binding_set_find</a> (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *set_name</code></em>); -<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="gtk3-Bindings.html#gtk-bindings-activate" title="gtk_bindings_activate ()">gtk_bindings_activate</a> (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *object</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> keyval</code></em>, - <em class="parameter"><code><a href="http://developer.gnome.org/gdk/gdk3-Windows.html#GdkModifierType"><span class="type">GdkModifierType</span></a> modifiers</code></em>); -<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="gtk3-Bindings.html#gtk-bindings-activate-event" title="gtk_bindings_activate_event ()">gtk_bindings_activate_event</a> (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *object</code></em>, - <em class="parameter"><code><a href="http://developer.gnome.org/gdk/gdk3-Event-Structures.html#GdkEventKey"><span class="type">GdkEventKey</span></a> *event</code></em>); -<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="gtk3-Bindings.html#gtk-binding-set-activate" title="gtk_binding_set_activate ()">gtk_binding_set_activate</a> (<em class="parameter"><code><a class="link" href="gtk3-Bindings.html#GtkBindingSet" title="struct GtkBindingSet"><span class="type">GtkBindingSet</span></a> *binding_set</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> keyval</code></em>, - <em class="parameter"><code><a href="http://developer.gnome.org/gdk/gdk3-Windows.html#GdkModifierType"><span class="type">GdkModifierType</span></a> modifiers</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *object</code></em>); -<span class="returnvalue">void</span> <a class="link" href="gtk3-Bindings.html#gtk-binding-entry-add-signal" title="gtk_binding_entry_add_signal ()">gtk_binding_entry_add_signal</a> (<em class="parameter"><code><a class="link" href="gtk3-Bindings.html#GtkBindingSet" title="struct GtkBindingSet"><span class="type">GtkBindingSet</span></a> *binding_set</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> keyval</code></em>, - <em class="parameter"><code><a href="http://developer.gnome.org/gdk/gdk3-Windows.html#GdkModifierType"><span class="type">GdkModifierType</span></a> modifiers</code></em>, - <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *signal_name</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> n_args</code></em>, - <em class="parameter"><code>...</code></em>); -<a href="http://library.gnome.org/devel/glib/unstable/glib-Lexical-Scanner.html#GTokenType"><span class="returnvalue">GTokenType</span></a> <a class="link" href="gtk3-Bindings.html#gtk-binding-entry-add-signal-from-string" title="gtk_binding_entry_add_signal_from_string ()">gtk_binding_entry_add_signal_from_string</a> - (<em class="parameter"><code><a class="link" href="gtk3-Bindings.html#GtkBindingSet" title="struct GtkBindingSet"><span class="type">GtkBindingSet</span></a> *binding_set</code></em>, - <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *signal_desc</code></em>); -<span class="returnvalue">void</span> <a class="link" href="gtk3-Bindings.html#gtk-binding-entry-skip" title="gtk_binding_entry_skip ()">gtk_binding_entry_skip</a> (<em class="parameter"><code><a class="link" href="gtk3-Bindings.html#GtkBindingSet" title="struct GtkBindingSet"><span class="type">GtkBindingSet</span></a> *binding_set</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> keyval</code></em>, - <em class="parameter"><code><a href="http://developer.gnome.org/gdk/gdk3-Windows.html#GdkModifierType"><span class="type">GdkModifierType</span></a> modifiers</code></em>); -<span class="returnvalue">void</span> <a class="link" href="gtk3-Bindings.html#gtk-binding-entry-remove" title="gtk_binding_entry_remove ()">gtk_binding_entry_remove</a> (<em class="parameter"><code><a class="link" href="gtk3-Bindings.html#GtkBindingSet" title="struct GtkBindingSet"><span class="type">GtkBindingSet</span></a> *binding_set</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> keyval</code></em>, - <em class="parameter"><code><a href="http://developer.gnome.org/gdk/gdk3-Windows.html#GdkModifierType"><span class="type">GdkModifierType</span></a> modifiers</code></em>); -<span class="returnvalue">void</span> <a class="link" href="gtk3-Bindings.html#gtk-binding-set-add-path" title="gtk_binding_set_add_path ()">gtk_binding_set_add_path</a> (<em class="parameter"><code><a class="link" href="gtk3-Bindings.html#GtkBindingSet" title="struct GtkBindingSet"><span class="type">GtkBindingSet</span></a> *binding_set</code></em>, - <em class="parameter"><code><a class="link" href="gtk3-Standard-Enumerations.html#GtkPathType" title="enum GtkPathType"><span class="type">GtkPathType</span></a> path_type</code></em>, - <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *path_pattern</code></em>, - <em class="parameter"><code><a class="link" href="gtk3-Standard-Enumerations.html#GtkPathPriorityType" title="enum GtkPathPriorityType"><span class="type">GtkPathPriorityType</span></a> priority</code></em>); -</pre> -</div> -<div class="refsect1"> -<a name="gtk3-Bindings.description"></a><h2>Description</h2> -<p> -<a class="link" href="gtk3-Bindings.html#GtkBindingSet" title="struct GtkBindingSet"><span class="type">GtkBindingSet</span></a> provides a mechanism for configuring GTK+ key bindings -through CSS files. This eases key binding adjustments for application -developers as well as users and provides GTK+ users or administrators -with high key binding configurability which requires no application -or toolkit side changes. -</p> -<p> -</p> -<div class="refsect2"> -<a name="gtk-bindings-install"></a><h3>Installing a key binding</h3> -<p> -A CSS file binding consists of a 'binding-set' definition and a match -statement to apply the binding set to specific widget types. Details -on the matching mechanism are described under -<a class="link" href="GtkCssProvider.html#gtkcssprovider-selectors" title="Selectors">Selectors</a> -in the <a class="link" href="GtkCssProvider.html" title="GtkCssProvider"><span class="type">GtkCssProvider</span></a> documentation. Inside the binding set definition, -key combinations are bound to one or more specific signal emissions on -the target widget. Key combinations are strings consisting of an optional -<a href="http://developer.gnome.org/gdk/gdk3-Windows.html#GdkModifierType"><span class="type">GdkModifierType</span></a> name and <a href="http://library.gnome.org/devel/gdk3/gdk-Keyboard-Handling.html">key names</a> -such as those defined in <code class="filename"><gdk/gdkkeysyms.h></code> -or returned from <a href="http://developer.gnome.org/gdk/gdk3-Keyboard-Handling.html#gdk-keyval-name"><code class="function">gdk_keyval_name()</code></a>, they have to be parsable by -<a class="link" href="gtk3-Keyboard-Accelerators.html#gtk-accelerator-parse" title="gtk_accelerator_parse ()"><code class="function">gtk_accelerator_parse()</code></a>. Specifications of signal emissions consist -of a string identifying the signal name, and a list of signal specific -arguments in parenthesis. -</p> -<p> -For example for binding Control and the left or right cursor keys -of a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> widget to the <a class="link" href="GtkEntry.html#GtkEntry-move-cursor" title='The "move-cursor" signal'><span class="type">"move-cursor"</span></a> signal (so movement -occurs in 3-character steps), the following binding can be used: -</p> -<div class="informalexample"> - <table class="listing_frame" border="0" cellpadding="0" cellspacing="0"> - <tbody> - <tr> - <td class="listing_lines" align="right"><pre>1 -2 -3 -4 -5 -6 -7 -8 -9</pre></td> - <td class="listing_code"><pre class="programlisting"><span class="normal">@binding</span><span class="symbol">-</span><span class="normal">set MoveCursor3</span> -<span class="cbracket">{</span> -<span class="normal"> bind </span><span class="string">"<Control>Right"</span><span class="normal"> </span><span class="cbracket">{</span><span class="normal"> </span><span class="string">"move-cursor"</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">visual</span><span class="symbol">-</span><span class="normal">positions</span><span class="symbol">,</span><span class="normal"> </span><span class="number">3</span><span class="symbol">,</span><span class="normal"> </span><span class="number">0</span><span class="symbol">)</span><span class="normal"> </span><span class="cbracket">}</span><span class="symbol">;</span> -<span class="normal"> bind </span><span class="string">"<Control>Left"</span><span class="normal"> </span><span class="cbracket">{</span><span class="normal"> </span><span class="string">"move-cursor"</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">visual</span><span class="symbol">-</span><span class="normal">positions</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">-</span><span class="number">3</span><span class="symbol">,</span><span class="normal"> </span><span class="number">0</span><span class="symbol">)</span><span class="normal"> </span><span class="cbracket">}</span><span class="symbol">;</span> -<span class="cbracket">}</span><span class="symbol">;</span> -<span class="normal"><a href="GtkEntry.html">GtkEntry</a></span> -<span class="cbracket">{</span> -<span class="normal"> gtk</span><span class="symbol">-</span><span class="normal">key</span><span class="symbol">-</span><span class="normal">bindings</span><span class="symbol">:</span><span class="normal"> MoveCursor3</span> -<span class="cbracket">}</span></pre></td> - </tr> - </tbody> - </table> -</div> - -<p> -</p> -</div> -<p> -</p> -<hr> -<div class="refsect2"> -<a name="gtk-bindings-unbind"></a><h3>Unbinding existing key bindings</h3> -<p> -GTK+ already defines a number of useful bindings for the widgets -it provides. Because custom bindings set up in CSS files take -precedence over the default bindings shipped with GTK+, overriding -existing bindings as demonstrated in -<a class="link" href="gtk3-Bindings.html#gtk-bindings-install" title="Installing a key binding">Installing a key binding</a> -works as expected. The same mechanism can not be used to "unbind" -existing bindings, however. -</p> -<div class="informalexample"> - <table class="listing_frame" border="0" cellpadding="0" cellspacing="0"> - <tbody> - <tr> - <td class="listing_lines" align="right"><pre>1 -2 -3 -4 -5 -6 -7 -8 -9</pre></td> - <td class="listing_code"><pre class="programlisting"><span class="normal">@binding</span><span class="symbol">-</span><span class="normal">set MoveCursor3</span> -<span class="cbracket">{</span> -<span class="normal"> bind </span><span class="string">"<Control>Right"</span><span class="normal"> </span><span class="cbracket">{</span><span class="normal"> </span><span class="cbracket">}</span><span class="symbol">;</span> -<span class="normal"> bind </span><span class="string">"<Control>Left"</span><span class="normal"> </span><span class="cbracket">{</span><span class="normal"> </span><span class="cbracket">}</span><span class="symbol">;</span> -<span class="cbracket">}</span><span class="symbol">;</span> -<span class="normal"><a href="GtkEntry.html">GtkEntry</a></span> -<span class="cbracket">{</span> -<span class="normal"> gtk</span><span class="symbol">-</span><span class="normal">key</span><span class="symbol">-</span><span class="normal">bindings</span><span class="symbol">:</span><span class="normal"> MoveCursor3</span> -<span class="cbracket">}</span></pre></td> - </tr> - </tbody> - </table> -</div> - -<p> -The above example will not have the desired effect of causing -"<Control>Right" and "<Control>Left" key presses to -be ignored by GTK+. Instead, it just causes any existing bindings -from the bindings set "MoveCursor3" to be deleted, so when -"<Control>Right" or "<Control>Left" are pressed, no -binding for these keys is found in binding set "MoveCursor3". -GTK+ will thus continue to search for matching key bindings, and will -eventually lookup and find the default GTK+ bindings for entries which -implement word movement. To keep GTK+ from activating its default -bindings, the "unbind" keyword can be used like this: -</p> -<div class="informalexample"> - <table class="listing_frame" border="0" cellpadding="0" cellspacing="0"> - <tbody> - <tr> - <td class="listing_lines" align="right"><pre>1 -2 -3 -4 -5 -6 -7 -8 -9</pre></td> - <td class="listing_code"><pre class="programlisting"><span class="normal">@binding</span><span class="symbol">-</span><span class="normal">set MoveCursor3</span> -<span class="cbracket">{</span> -<span class="normal"> unbind </span><span class="string">"<Control>Right"</span><span class="symbol">;</span> -<span class="normal"> unbind </span><span class="string">"<Control>Left"</span><span class="symbol">;</span> -<span class="cbracket">}</span><span class="symbol">;</span> -<span class="normal"><a href="GtkEntry.html">GtkEntry</a></span> -<span class="cbracket">{</span> -<span class="normal"> gtk</span><span class="symbol">-</span><span class="normal">key</span><span class="symbol">-</span><span class="normal">bindings</span><span class="symbol">:</span><span class="normal"> MoveCursor3</span> -<span class="cbracket">}</span></pre></td> - </tr> - </tbody> - </table> -</div> - -<p> -Now, GTK+ will find a match when looking up "<Control>Right" -and "<Control>Left" key presses before it resorts to its default -bindings, and the match instructs it to abort ("unbind") the search, -so the key presses are not consumed by this widget. As usual, further -processing of the key presses, e.g. by an entry's parent widget, is -now possible. -</p> -</div> -<p> -</p> -</div> -<div class="refsect1"> -<a name="gtk3-Bindings.details"></a><h2>Details</h2> -<div class="refsect2"> -<a name="GtkBindingSet"></a><h3>struct GtkBindingSet</h3> -<pre class="programlisting">struct GtkBindingSet { - gchar *set_name; - gint priority; - GSList *widget_path_pspecs; - GSList *widget_class_pspecs; - GSList *class_branch_pspecs; - GtkBindingEntry *entries; - GtkBindingEntry *current; - guint parsed : 1; -}; -</pre> -<p> -A binding set maintains a list of activatable key bindings. -A single binding set can match multiple types of widgets. -Similar to style contexts, can be matched by any information contained -in a widgets <a class="link" href="gtk3-GtkWidgetPath.html#GtkWidgetPath" title="GtkWidgetPath"><span class="type">GtkWidgetPath</span></a>. When a binding within a set is matched upon -activation, an action signal is emitted on the target widget to carry out -the actual activation. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *<em class="structfield"><code><a name="GtkBindingSet.set-name"></a>set_name</code></em>;</span></p></td> -<td>unique name of this binding set</td> -</tr> -<tr> -<td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> <em class="structfield"><code><a name="GtkBindingSet.priority"></a>priority</code></em>;</span></p></td> -<td>unused</td> -</tr> -<tr> -<td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a> *<em class="structfield"><code><a name="GtkBindingSet.widget-path-pspecs"></a>widget_path_pspecs</code></em>;</span></p></td> -<td>unused</td> -</tr> -<tr> -<td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a> *<em class="structfield"><code><a name="GtkBindingSet.widget-class-pspecs"></a>widget_class_pspecs</code></em>;</span></p></td> -<td>unused</td> -</tr> -<tr> -<td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a> *<em class="structfield"><code><a name="GtkBindingSet.class-branch-pspecs"></a>class_branch_pspecs</code></em>;</span></p></td> -<td>unused</td> -</tr> -<tr> -<td><p><span class="term"><a class="link" href="gtk3-Bindings.html#GtkBindingEntry" title="struct GtkBindingEntry"><span class="type">GtkBindingEntry</span></a> *<em class="structfield"><code><a name="GtkBindingSet.entries"></a>entries</code></em>;</span></p></td> -<td>the key binding entries in this binding set</td> -</tr> -<tr> -<td><p><span class="term"><a class="link" href="gtk3-Bindings.html#GtkBindingEntry" title="struct GtkBindingEntry"><span class="type">GtkBindingEntry</span></a> *<em class="structfield"><code><a name="GtkBindingSet.current"></a>current</code></em>;</span></p></td> -<td>implementation detail</td> -</tr> -<tr> -<td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> <em class="structfield"><code><a name="GtkBindingSet.parsed"></a>parsed</code></em> : 1;</span></p></td> -<td>whether this binding set stems from a CSS file and is reset upon theme changes</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="GtkBindingEntry"></a><h3>struct GtkBindingEntry</h3> -<pre class="programlisting">struct GtkBindingEntry { - /* key portion */ - guint keyval; - GdkModifierType modifiers; - - GtkBindingSet *binding_set; - guint destroyed : 1; - guint in_emission : 1; - guint marks_unbound : 1; - GtkBindingEntry *set_next; - GtkBindingEntry *hash_next; - GtkBindingSignal *signals; -}; -</pre> -<p> -Each key binding element of a binding sets binding list is -represented by a GtkBindingEntry. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> <em class="structfield"><code><a name="GtkBindingEntry.keyval"></a>keyval</code></em>;</span></p></td> -<td>key value to match</td> -</tr> -<tr> -<td><p><span class="term"><a href="http://developer.gnome.org/gdk/gdk3-Windows.html#GdkModifierType"><span class="type">GdkModifierType</span></a> <em class="structfield"><code><a name="GtkBindingEntry.modifiers"></a>modifiers</code></em>;</span></p></td> -<td>key modifiers to match</td> -</tr> -<tr> -<td><p><span class="term"><a class="link" href="gtk3-Bindings.html#GtkBindingSet" title="struct GtkBindingSet"><span class="type">GtkBindingSet</span></a> *<em class="structfield"><code><a name="GtkBindingEntry.binding-set"></a>binding_set</code></em>;</span></p></td> -<td>binding set this entry belongs to</td> -</tr> -<tr> -<td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> <em class="structfield"><code><a name="GtkBindingEntry.destroyed"></a>destroyed</code></em> : 1;</span></p></td> -<td>implementation detail</td> -</tr> -<tr> -<td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> <em class="structfield"><code><a name="GtkBindingEntry.in-emission"></a>in_emission</code></em> : 1;</span></p></td> -<td>implementation detail</td> -</tr> -<tr> -<td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> <em class="structfield"><code><a name="GtkBindingEntry.marks-unbound"></a>marks_unbound</code></em> : 1;</span></p></td> -<td>implementation detail</td> -</tr> -<tr> -<td><p><span class="term"><a class="link" href="gtk3-Bindings.html#GtkBindingEntry" title="struct GtkBindingEntry"><span class="type">GtkBindingEntry</span></a> *<em class="structfield"><code><a name="GtkBindingEntry.set-next"></a>set_next</code></em>;</span></p></td> -<td>linked list of entries maintained by binding set</td> -</tr> -<tr> -<td><p><span class="term"><a class="link" href="gtk3-Bindings.html#GtkBindingEntry" title="struct GtkBindingEntry"><span class="type">GtkBindingEntry</span></a> *<em class="structfield"><code><a name="GtkBindingEntry.hash-next"></a>hash_next</code></em>;</span></p></td> -<td>implementation detail</td> -</tr> -<tr> -<td><p><span class="term"><a class="link" href="gtk3-Bindings.html#GtkBindingSignal" title="struct GtkBindingSignal"><span class="type">GtkBindingSignal</span></a> *<em class="structfield"><code><a name="GtkBindingEntry.signals"></a>signals</code></em>;</span></p></td> -<td>action signals of this entry</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="GtkBindingSignal"></a><h3>struct GtkBindingSignal</h3> -<pre class="programlisting">struct GtkBindingSignal { - GtkBindingSignal *next; - gchar *signal_name; - guint n_args; - GtkBindingArg *args; -}; -</pre> -<p> -<a name="keybinding-signals"></a> -A GtkBindingSignal stores the necessary information to -activate a widget in response to a key press via a signal -emission. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><a class="link" href="gtk3-Bindings.html#GtkBindingSignal" title="struct GtkBindingSignal"><span class="type">GtkBindingSignal</span></a> *<em class="structfield"><code><a name="GtkBindingSignal.next"></a>next</code></em>;</span></p></td> -<td>implementation detail</td> -</tr> -<tr> -<td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *<em class="structfield"><code><a name="GtkBindingSignal.signal-name"></a>signal_name</code></em>;</span></p></td> -<td>the action signal to be emitted</td> -</tr> -<tr> -<td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> <em class="structfield"><code><a name="GtkBindingSignal.n-args"></a>n_args</code></em>;</span></p></td> -<td>number of arguments specified for the signal</td> -</tr> -<tr> -<td><p><span class="term"><a class="link" href="gtk3-Bindings.html#GtkBindingArg" title="struct GtkBindingArg"><span class="type">GtkBindingArg</span></a> *<em class="structfield"><code><a name="GtkBindingSignal.args"></a>args</code></em>;</span></p></td> -<td>the arguments specified for the signal</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="GtkBindingArg"></a><h3>struct GtkBindingArg</h3> -<pre class="programlisting">struct GtkBindingArg { - GType arg_type; - union { - glong long_data; - gdouble double_data; - gchar *string_data; - } d; -}; -</pre> -<p> -A <a class="link" href="gtk3-Bindings.html#GtkBindingArg" title="struct GtkBindingArg"><span class="type">GtkBindingArg</span></a> holds the data associated with -an argument for a key binding signal emission as -stored in <a class="link" href="gtk3-Bindings.html#GtkBindingSignal" title="struct GtkBindingSignal"><span class="type">GtkBindingSignal</span></a>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody><tr> -<td><p><span class="term"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> <em class="structfield"><code><a name="GtkBindingArg.arg-type"></a>arg_type</code></em>;</span></p></td> -<td>implementation detail</td> -</tr></tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-binding-entry-add-signall"></a><h3>gtk_binding_entry_add_signall ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_binding_entry_add_signall (<em class="parameter"><code><a class="link" href="gtk3-Bindings.html#GtkBindingSet" title="struct GtkBindingSet"><span class="type">GtkBindingSet</span></a> *binding_set</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> keyval</code></em>, - <em class="parameter"><code><a href="http://developer.gnome.org/gdk/gdk3-Windows.html#GdkModifierType"><span class="type">GdkModifierType</span></a> modifiers</code></em>, - <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *signal_name</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a> *binding_args</code></em>);</pre> -<p> -Override or install a new key binding for <em class="parameter"><code>keyval</code></em> with <em class="parameter"><code>modifiers</code></em> on -<em class="parameter"><code>binding_set</code></em>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>binding_set</code></em> :</span></p></td> -<td>a <a class="link" href="gtk3-Bindings.html#GtkBindingSet" title="struct GtkBindingSet"><span class="type">GtkBindingSet</span></a> to add a signal to</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>keyval</code></em> :</span></p></td> -<td>key value</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>modifiers</code></em> :</span></p></td> -<td>key modifier</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>signal_name</code></em> :</span></p></td> -<td>signal name to be bound</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>binding_args</code></em> :</span></p></td> -<td>list of <a class="link" href="gtk3-Bindings.html#GtkBindingArg" title="struct GtkBindingArg"><span class="type">GtkBindingArg</span></a> signal arguments. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> GtkBindingArg]</span> -</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-binding-set-new"></a><h3>gtk_binding_set_new ()</h3> -<pre class="programlisting"><a class="link" href="gtk3-Bindings.html#GtkBindingSet" title="struct GtkBindingSet"><span class="returnvalue">GtkBindingSet</span></a> * gtk_binding_set_new (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *set_name</code></em>);</pre> -<p> -GTK+ maintains a global list of binding sets. Each binding set has -a unique name which needs to be specified upon creation. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>set_name</code></em> :</span></p></td> -<td>unique name of this binding set</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>new binding set. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span> -</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-binding-set-by-class"></a><h3>gtk_binding_set_by_class ()</h3> -<pre class="programlisting"><a class="link" href="gtk3-Bindings.html#GtkBindingSet" title="struct GtkBindingSet"><span class="returnvalue">GtkBindingSet</span></a> * gtk_binding_set_by_class (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> object_class</code></em>);</pre> -<p> -This function returns the binding set named after the type name of -the passed in class structure. New binding sets are created on -demand by this function. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>object_class</code></em> :</span></p></td> -<td>a valid <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> class</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>the binding set corresponding to -<em class="parameter"><code>object_class</code></em>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span> -</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-binding-set-find"></a><h3>gtk_binding_set_find ()</h3> -<pre class="programlisting"><a class="link" href="gtk3-Bindings.html#GtkBindingSet" title="struct GtkBindingSet"><span class="returnvalue">GtkBindingSet</span></a> * gtk_binding_set_find (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *set_name</code></em>);</pre> -<p> -Find a binding set by its globally unique name. -</p> -<p> -The <em class="parameter"><code>set_name</code></em> can either be a name used for <a class="link" href="gtk3-Bindings.html#gtk-binding-set-new" title="gtk_binding_set_new ()"><code class="function">gtk_binding_set_new()</code></a> -or the type name of a class used in <a class="link" href="gtk3-Bindings.html#gtk-binding-set-by-class" title="gtk_binding_set_by_class ()"><code class="function">gtk_binding_set_by_class()</code></a>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>set_name</code></em> :</span></p></td> -<td>unique binding set name</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td> -<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> or the specified binding set. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span> -</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-bindings-activate"></a><h3>gtk_bindings_activate ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gtk_bindings_activate (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *object</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> keyval</code></em>, - <em class="parameter"><code><a href="http://developer.gnome.org/gdk/gdk3-Windows.html#GdkModifierType"><span class="type">GdkModifierType</span></a> modifiers</code></em>);</pre> -<p> -Find a key binding matching <em class="parameter"><code>keyval</code></em> and <em class="parameter"><code>modifiers</code></em> and activate the -binding on <em class="parameter"><code>object</code></em>. -</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> :</span></p></td> -<td>object to activate when binding found</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>keyval</code></em> :</span></p></td> -<td>key value of the binding</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>modifiers</code></em> :</span></p></td> -<td>key modifier of the binding</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td> -<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if a binding was found and activated</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-bindings-activate-event"></a><h3>gtk_bindings_activate_event ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gtk_bindings_activate_event (<em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *object</code></em>, - <em class="parameter"><code><a href="http://developer.gnome.org/gdk/gdk3-Event-Structures.html#GdkEventKey"><span class="type">GdkEventKey</span></a> *event</code></em>);</pre> -<p> -Looks up key bindings for <em class="parameter"><code>object</code></em> to find one matching -<em class="parameter"><code>event</code></em>, and if one was found, activate it. -</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> :</span></p></td> -<td>a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> (generally must be a widget)</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>event</code></em> :</span></p></td> -<td>a <a href="http://developer.gnome.org/gdk/gdk3-Event-Structures.html#GdkEventKey"><span class="type">GdkEventKey</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td> -<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if a matching key binding was found</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.4</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-binding-set-activate"></a><h3>gtk_binding_set_activate ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gtk_binding_set_activate (<em class="parameter"><code><a class="link" href="gtk3-Bindings.html#GtkBindingSet" title="struct GtkBindingSet"><span class="type">GtkBindingSet</span></a> *binding_set</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> keyval</code></em>, - <em class="parameter"><code><a href="http://developer.gnome.org/gdk/gdk3-Windows.html#GdkModifierType"><span class="type">GdkModifierType</span></a> modifiers</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *object</code></em>);</pre> -<p> -Find a key binding matching <em class="parameter"><code>keyval</code></em> and <em class="parameter"><code>modifiers</code></em> within -<em class="parameter"><code>binding_set</code></em> and activate the binding on <em class="parameter"><code>object</code></em>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>binding_set</code></em> :</span></p></td> -<td>a <a class="link" href="gtk3-Bindings.html#GtkBindingSet" title="struct GtkBindingSet"><span class="type">GtkBindingSet</span></a> set to activate</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>keyval</code></em> :</span></p></td> -<td>key value of the binding</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>modifiers</code></em> :</span></p></td> -<td>key modifier of the binding</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>object</code></em> :</span></p></td> -<td>object to activate when binding found</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td> -<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if a binding was found and activated</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-binding-entry-add-signal"></a><h3>gtk_binding_entry_add_signal ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_binding_entry_add_signal (<em class="parameter"><code><a class="link" href="gtk3-Bindings.html#GtkBindingSet" title="struct GtkBindingSet"><span class="type">GtkBindingSet</span></a> *binding_set</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> keyval</code></em>, - <em class="parameter"><code><a href="http://developer.gnome.org/gdk/gdk3-Windows.html#GdkModifierType"><span class="type">GdkModifierType</span></a> modifiers</code></em>, - <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *signal_name</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> n_args</code></em>, - <em class="parameter"><code>...</code></em>);</pre> -<p> -Override or install a new key binding for <em class="parameter"><code>keyval</code></em> with <em class="parameter"><code>modifiers</code></em> on -<em class="parameter"><code>binding_set</code></em>. When the binding is activated, <em class="parameter"><code>signal_name</code></em> will be -emitted on the target widget, with <em class="parameter"><code>n_args</code></em> <em class="parameter"><code>Varargs</code></em> used as -arguments. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>binding_set</code></em> :</span></p></td> -<td>a <a class="link" href="gtk3-Bindings.html#GtkBindingSet" title="struct GtkBindingSet"><span class="type">GtkBindingSet</span></a> to install an entry for</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>keyval</code></em> :</span></p></td> -<td>key value of binding to install</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>modifiers</code></em> :</span></p></td> -<td>key modifier of binding to install</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>signal_name</code></em> :</span></p></td> -<td>signal to execute upon activation</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>n_args</code></em> :</span></p></td> -<td>number of arguments to <em class="parameter"><code>signal_name</code></em> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td> -<td>arguments to <em class="parameter"><code>signal_name</code></em> -</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-binding-entry-add-signal-from-string"></a><h3>gtk_binding_entry_add_signal_from_string ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Lexical-Scanner.html#GTokenType"><span class="returnvalue">GTokenType</span></a> gtk_binding_entry_add_signal_from_string - (<em class="parameter"><code><a class="link" href="gtk3-Bindings.html#GtkBindingSet" title="struct GtkBindingSet"><span class="type">GtkBindingSet</span></a> *binding_set</code></em>, - <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *signal_desc</code></em>);</pre> -<p> -Parses a signal description from <em class="parameter"><code>signal_desc</code></em> and incorporates -it into <em class="parameter"><code>binding_set</code></em>. -</p> -<p> -Signal descriptions may either bind a key combination to -one or more signals: -</p> -<div class="informalexample"> - <table class="listing_frame" border="0" cellpadding="0" cellspacing="0"> - <tbody> - <tr> - <td class="listing_lines" align="right"><pre>1 -2 -3 -4</pre></td> - <td class="listing_code"><pre class="programlisting"><span class="normal">bind </span><span class="string">"key"</span><span class="normal"> </span><span class="cbracket">{</span> -<span class="normal"> </span><span class="string">"signalname"</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">param</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">...)</span> -<span class="normal"> </span><span class="symbol">...</span> -<span class="cbracket">}</span></pre></td> - </tr> - </tbody> - </table> -</div> - -<p> -</p> -<p> -Or they may also unbind a key combination: -</p> -<div class="informalexample"> - <table class="listing_frame" border="0" cellpadding="0" cellspacing="0"> - <tbody> - <tr> - <td class="listing_lines" align="right"><pre>1</pre></td> - <td class="listing_code"><pre class="programlisting"><span class="normal">unbind </span><span class="string">"key"</span></pre></td> - </tr> - </tbody> - </table> -</div> - -<p> -</p> -<p> -Key combinations must be in a format that can be parsed by -<a class="link" href="gtk3-Keyboard-Accelerators.html#gtk-accelerator-parse" title="gtk_accelerator_parse ()"><code class="function">gtk_accelerator_parse()</code></a>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>binding_set</code></em> :</span></p></td> -<td>a <a class="link" href="gtk3-Bindings.html#GtkBindingSet" title="struct GtkBindingSet"><span class="type">GtkBindingSet</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>signal_desc</code></em> :</span></p></td> -<td>a signal description</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td> -<code class="literal">G_TOKEN_NONE</code> if the signal was successfully parsed and added, -the expected token otherwise</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 3.0</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-binding-entry-skip"></a><h3>gtk_binding_entry_skip ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_binding_entry_skip (<em class="parameter"><code><a class="link" href="gtk3-Bindings.html#GtkBindingSet" title="struct GtkBindingSet"><span class="type">GtkBindingSet</span></a> *binding_set</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> keyval</code></em>, - <em class="parameter"><code><a href="http://developer.gnome.org/gdk/gdk3-Windows.html#GdkModifierType"><span class="type">GdkModifierType</span></a> modifiers</code></em>);</pre> -<p> -Install a binding on <em class="parameter"><code>binding_set</code></em> which causes key lookups -to be aborted, to prevent bindings from lower priority sets -to be activated. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>binding_set</code></em> :</span></p></td> -<td>a <a class="link" href="gtk3-Bindings.html#GtkBindingSet" title="struct GtkBindingSet"><span class="type">GtkBindingSet</span></a> to skip an entry of</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>keyval</code></em> :</span></p></td> -<td>key value of binding to skip</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>modifiers</code></em> :</span></p></td> -<td>key modifier of binding to skip</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.12</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-binding-entry-remove"></a><h3>gtk_binding_entry_remove ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_binding_entry_remove (<em class="parameter"><code><a class="link" href="gtk3-Bindings.html#GtkBindingSet" title="struct GtkBindingSet"><span class="type">GtkBindingSet</span></a> *binding_set</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> keyval</code></em>, - <em class="parameter"><code><a href="http://developer.gnome.org/gdk/gdk3-Windows.html#GdkModifierType"><span class="type">GdkModifierType</span></a> modifiers</code></em>);</pre> -<p> -Remove a binding previously installed via -<a class="link" href="gtk3-Bindings.html#gtk-binding-entry-add-signal" title="gtk_binding_entry_add_signal ()"><code class="function">gtk_binding_entry_add_signal()</code></a> on <em class="parameter"><code>binding_set</code></em>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>binding_set</code></em> :</span></p></td> -<td>a <a class="link" href="gtk3-Bindings.html#GtkBindingSet" title="struct GtkBindingSet"><span class="type">GtkBindingSet</span></a> to remove an entry of</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>keyval</code></em> :</span></p></td> -<td>key value of binding to remove</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>modifiers</code></em> :</span></p></td> -<td>key modifier of binding to remove</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-binding-set-add-path"></a><h3>gtk_binding_set_add_path ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_binding_set_add_path (<em class="parameter"><code><a class="link" href="gtk3-Bindings.html#GtkBindingSet" title="struct GtkBindingSet"><span class="type">GtkBindingSet</span></a> *binding_set</code></em>, - <em class="parameter"><code><a class="link" href="gtk3-Standard-Enumerations.html#GtkPathType" title="enum GtkPathType"><span class="type">GtkPathType</span></a> path_type</code></em>, - <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *path_pattern</code></em>, - <em class="parameter"><code><a class="link" href="gtk3-Standard-Enumerations.html#GtkPathPriorityType" title="enum GtkPathPriorityType"><span class="type">GtkPathPriorityType</span></a> priority</code></em>);</pre> -<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"> -<h3 class="title">Warning</h3> -<p><code class="literal">gtk_binding_set_add_path</code> is deprecated and should not be used in newly-written code. 3.0</p> -</div> -<p> -This function was used internally by the GtkRC parsing mechanism -to assign match patterns to <a class="link" href="gtk3-Bindings.html#GtkBindingSet" title="struct GtkBindingSet"><span class="type">GtkBindingSet</span></a> structures. -</p> -<p> -In GTK+ 3, these match patterns are unused. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>binding_set</code></em> :</span></p></td> -<td>a <a class="link" href="gtk3-Bindings.html#GtkBindingSet" title="struct GtkBindingSet"><span class="type">GtkBindingSet</span></a> to add a path to</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>path_type</code></em> :</span></p></td> -<td>path type the pattern applies to</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>path_pattern</code></em> :</span></p></td> -<td>the actual match pattern</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>priority</code></em> :</span></p></td> -<td>binding priority</td> -</tr> -</tbody> -</table></div> -</div> -</div> -<div class="refsect1"> -<a name="gtk3-Bindings.see-also"></a><h2>See Also</h2> -Keyboard Accelerators, Mnemonics, <a class="link" href="GtkCssProvider.html" title="GtkCssProvider"><span class="type">GtkCssProvider</span></a> -</div> -</div> -<div class="footer"> -<hr> - Generated by GTK-Doc V1.18.1</div> -</body> -</html>
\ No newline at end of file |