Files
gimp/devel-docs/libgimpwidgets/html/GimpController.html
2010-08-11 01:25:38 -04:00

391 lines
16 KiB
HTML
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>GimpController</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
<link rel="start" href="index.html" title="GIMP Widgets Library Reference Manual">
<link rel="up" href="libgimpwidgets-controller.html" title="Part IV. GIMP Controllers">
<link rel="prev" href="libgimpwidgets-controller.html" title="Part IV. GIMP Controllers">
<link rel="next" href="libgimpwidgets-utils.html" title="Part V. GIMP Widgets Utilities">
<meta name="generator" content="GTK-Doc V1.10 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
<link rel="part" href="libgimpwidgets-widgets.html" title="Part I. GIMP Widgets">
<link rel="chapter" href="libgimpwidgets-hierarchy.html" title="Object Hierarchy">
<link rel="chapter" href="libgimpwidgets-gallery.html" title="Widget Gallery">
<link rel="chapter" href="libgimpwidgets-cell-renderers.html" title="Cell Renderers for GtkTreeView">
<link rel="part" href="libgimpwidgets-colordisplay.html" title="Part II. GIMP Display Filters">
<link rel="part" href="libgimpwidgets-colorselector.html" title="Part III. GIMP Color Selectors">
<link rel="part" href="libgimpwidgets-controller.html" title="Part IV. GIMP Controllers">
<link rel="part" href="libgimpwidgets-utils.html" title="Part V. GIMP Widgets Utilities">
<link rel="part" href="libgimpwidgets-deprecated.html" title="Part VI. Deprecated API">
<link rel="index" href="libgimpwidgets-index.html" title="Index">
<link rel="index" href="libgimpwidgets-index-new-in-2-2.html" title="Index of new symbols in GIMP 2.2">
<link rel="index" href="libgimpwidgets-index-new-in-2-4.html" title="Index of new symbols in GIMP 2.4">
<link rel="index" href="libgimpwidgets-index-new-in-2-6.html" title="Index of new symbols in GIMP 2.6">
<link rel="index" href="libgimpwidgets-index-deprecated.html" title="Index of deprecated symbols">
</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="libgimpwidgets-controller.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
<td><a accesskey="u" href="libgimpwidgets-controller.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">GIMP Widgets Library Reference Manual</th>
<td><a accesskey="n" href="libgimpwidgets-utils.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
</tr>
<tr><td colspan="5" class="shortcuts"><nobr><a href="#GimpController.synopsis" class="shortcut">Top</a>
 | 
<a href="#GimpController.description" class="shortcut">Description</a>
 | 
<a href="#GimpController.object-hierarchy" class="shortcut">Object Hierarchy</a>
 | 
<a href="#GimpController.implemented-interfaces" class="shortcut">Implemented Interfaces</a>
 | 
<a href="#GimpController.properties" class="shortcut">Properties</a>
 | 
<a href="#GimpController.signals" class="shortcut">Signals</a></nobr></td></tr>
</table>
<div class="refentry" lang="en">
<a name="GimpController"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2><span class="refentrytitle"><a name="GimpController.top_of_page"></a>GimpController</span></h2>
<p>GimpController — Pluggable GIMP input controller modules.</p>
</td>
<td valign="top" align="right"></td>
</tr></table></div>
<div class="refsynopsisdiv">
<a name="GimpController.synopsis"></a><h2>Synopsis</h2>
<pre class="synopsis">
enum <a class="link" href="GimpController.html#GimpControllerEventType" title="enum GimpControllerEventType">GimpControllerEventType</a>;
<a class="link" href="GimpController.html#GimpControllerEventAny" title="GimpControllerEventAny">GimpControllerEventAny</a>;
<a class="link" href="GimpController.html#GimpControllerEventTrigger" title="GimpControllerEventTrigger">GimpControllerEventTrigger</a>;
<a class="link" href="GimpController.html#GimpControllerEventValue" title="GimpControllerEventValue">GimpControllerEventValue</a>;
union <a class="link" href="GimpController.html#GimpControllerEvent" title="union GimpControllerEvent">GimpControllerEvent</a>;
<a class="link" href="GimpController.html#GimpController-struct" title="GimpController">GimpController</a>;
<a class="link" href="GimpController.html" title="GimpController">GimpController</a>* <a class="link" href="GimpController.html#gimp-controller-new" title="gimp_controller_new ()">gimp_controller_new</a> (GType controller_type);
gint <a class="link" href="GimpController.html#gimp-controller-get-n-events" title="gimp_controller_get_n_events ()">gimp_controller_get_n_events</a> (<a class="link" href="GimpController.html" title="GimpController">GimpController</a> *controller);
const gchar* <a class="link" href="GimpController.html#gimp-controller-get-event-name" title="gimp_controller_get_event_name ()">gimp_controller_get_event_name</a> (<a class="link" href="GimpController.html" title="GimpController">GimpController</a> *controller,
gint event_id);
const gchar* <a class="link" href="GimpController.html#gimp-controller-get-event-blurb" title="gimp_controller_get_event_blurb ()">gimp_controller_get_event_blurb</a> (<a class="link" href="GimpController.html" title="GimpController">GimpController</a> *controller,
gint event_id);
gboolean <a class="link" href="GimpController.html#gimp-controller-event" title="gimp_controller_event ()">gimp_controller_event</a> (<a class="link" href="GimpController.html" title="GimpController">GimpController</a> *controller,
const <a class="link" href="GimpController.html#GimpControllerEvent" title="union GimpControllerEvent">GimpControllerEvent</a> *event);
</pre>
</div>
<div class="refsect1" lang="en">
<a name="GimpController.object-hierarchy"></a><h2>Object Hierarchy</h2>
<pre class="synopsis">
GObject
+----GimpController
</pre>
</div>
<div class="refsect1" lang="en">
<a name="GimpController.implemented-interfaces"></a><h2>Implemented Interfaces</h2>
<p>
GimpController implements
<a
href="../libgimpconfig/libgimpconfig-GimpConfig.html#GimpConfigInterface"
>GimpConfigInterface</a>.</p>
</div>
<div class="refsect1" lang="en">
<a name="GimpController.properties"></a><h2>Properties</h2>
<pre class="synopsis">
"<a class="link" href="GimpController.html#GimpController--name" title='The "name" property'>name</a>" gchar* : Read / Write / Construct
"<a class="link" href="GimpController.html#GimpController--state" title='The "state" property'>state</a>" gchar* : Read / Write / Construct
</pre>
</div>
<div class="refsect1" lang="en">
<a name="GimpController.signals"></a><h2>Signals</h2>
<pre class="synopsis">
"<a class="link" href="GimpController.html#GimpController-event" title='The "event" signal'>event</a>" : Run Last
</pre>
</div>
<div class="refsect1" lang="en">
<a name="GimpController.description"></a><h2>Description</h2>
<p>
An abstract interface for implementing arbitrary input controllers.
</p>
</div>
<div class="refsect1" lang="en">
<a name="GimpController.details"></a><h2>Details</h2>
<div class="refsect2" lang="en">
<a name="GimpControllerEventType"></a><h3>enum GimpControllerEventType</h3>
<pre class="programlisting">typedef enum
{
GIMP_CONTROLLER_EVENT_TRIGGER,
GIMP_CONTROLLER_EVENT_VALUE
} GimpControllerEventType;
</pre>
<p>
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="GimpControllerEventAny"></a><h3>GimpControllerEventAny</h3>
<pre class="programlisting">typedef struct {
GimpControllerEventType type;
GimpController *source;
gint event_id;
} GimpControllerEventAny;
</pre>
<p>
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="GimpControllerEventTrigger"></a><h3>GimpControllerEventTrigger</h3>
<pre class="programlisting">typedef struct {
GimpControllerEventType type;
GimpController *source;
gint event_id;
} GimpControllerEventTrigger;
</pre>
<p>
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="GimpControllerEventValue"></a><h3>GimpControllerEventValue</h3>
<pre class="programlisting">typedef struct {
GimpControllerEventType type;
GimpController *source;
gint event_id;
GValue value;
} GimpControllerEventValue;
</pre>
<p>
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="GimpControllerEvent"></a><h3>union GimpControllerEvent</h3>
<pre class="programlisting">union GimpControllerEvent
{
GimpControllerEventType type;
GimpControllerEventAny any;
GimpControllerEventTrigger trigger;
GimpControllerEventValue value;
};
</pre>
<p>
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="GimpController-struct"></a><h3>GimpController</h3>
<pre class="programlisting">typedef struct _GimpController GimpController;</pre>
<p>
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gimp-controller-new"></a><h3>gimp_controller_new ()</h3>
<pre class="programlisting"><a class="link" href="GimpController.html" title="GimpController">GimpController</a>* gimp_controller_new (GType controller_type);</pre>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>controller_type</code></em> :</span></p></td>
<td>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gimp-controller-get-n-events"></a><h3>gimp_controller_get_n_events ()</h3>
<pre class="programlisting">gint gimp_controller_get_n_events (<a class="link" href="GimpController.html" title="GimpController">GimpController</a> *controller);</pre>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>controller</code></em> :</span></p></td>
<td>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gimp-controller-get-event-name"></a><h3>gimp_controller_get_event_name ()</h3>
<pre class="programlisting">const gchar* gimp_controller_get_event_name (<a class="link" href="GimpController.html" title="GimpController">GimpController</a> *controller,
gint event_id);</pre>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>controller</code></em> :</span></p></td>
<td>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>event_id</code></em> :</span></p></td>
<td>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gimp-controller-get-event-blurb"></a><h3>gimp_controller_get_event_blurb ()</h3>
<pre class="programlisting">const gchar* gimp_controller_get_event_blurb (<a class="link" href="GimpController.html" title="GimpController">GimpController</a> *controller,
gint event_id);</pre>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>controller</code></em> :</span></p></td>
<td>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>event_id</code></em> :</span></p></td>
<td>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gimp-controller-event"></a><h3>gimp_controller_event ()</h3>
<pre class="programlisting">gboolean gimp_controller_event (<a class="link" href="GimpController.html" title="GimpController">GimpController</a> *controller,
const <a class="link" href="GimpController.html#GimpControllerEvent" title="union GimpControllerEvent">GimpControllerEvent</a> *event);</pre>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>controller</code></em> :</span></p></td>
<td>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>event</code></em> :</span></p></td>
<td>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>
</td>
</tr>
</tbody>
</table></div>
</div>
</div>
<div class="refsect1" lang="en">
<a name="GimpController.property-details"></a><h2>Property Details</h2>
<div class="refsect2" lang="en">
<a name="GimpController--name"></a><h3>The <code class="literal">"name"</code> property</h3>
<pre class="programlisting"> "name" gchar* : Read / Write / Construct</pre>
<p></p>
<p>Default value: "Unnamed Controller"</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="GimpController--state"></a><h3>The <code class="literal">"state"</code> property</h3>
<pre class="programlisting"> "state" gchar* : Read / Write / Construct</pre>
<p></p>
<p>Default value: "Unknown"</p>
</div>
</div>
<div class="refsect1" lang="en">
<a name="GimpController.signal-details"></a><h2>Signal Details</h2>
<div class="refsect2" lang="en">
<a name="GimpController-event"></a><h3>The <code class="literal">"event"</code> signal</h3>
<pre class="programlisting">gboolean user_function (<a class="link" href="GimpController.html" title="GimpController">GimpController</a> *gimpcontroller,
gpointer arg1,
gpointer user_data) : Run Last</pre>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>gimpcontroller</code></em> :</span></p></td>
<td>the object which received the signal.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>arg1</code></em> :</span></p></td>
<td>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</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> :</span></p></td>
<td>
</td>
</tr>
</tbody>
</table></div>
</div>
</div>
</div>
<div class="footer">
<hr>
Generated by GTK-Doc V1.10</div>
</body>
</html>