<refentry id="GtkInputDialog">
<refmeta>
<refentrytitle>GtkInputDialog</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>GTK Library</refmiscinfo>
</refmeta>

<refnamediv>
<refname>GtkInputDialog</refname><refpurpose>Configure devices for the XInput extension.</refpurpose>
</refnamediv>

<refsynopsisdiv><title>Synopsis</title>
<synopsis>

#include &lt;gtk/gtk.h&gt;


struct      <link linkend="GtkInputDialog-struct">GtkInputDialog</link>;
<link linkend="GtkWidget">GtkWidget</link>*  <link linkend="gtk-input-dialog-new">gtk_input_dialog_new</link>            (void);


</synopsis>
</refsynopsisdiv>

<refsect1>
<title>Object Hierarchy</title>
<synopsis>

  <link linkend="GObject">GObject</link>
   +----<link linkend="GtkObject">GtkObject</link>
         +----<link linkend="GtkWidget">GtkWidget</link>
               +----<link linkend="GtkContainer">GtkContainer</link>
                     +----<link linkend="GtkBin">GtkBin</link>
                           +----<link linkend="GtkWindow">GtkWindow</link>
                                 +----<link linkend="GtkDialog">GtkDialog</link>
                                       +----GtkInputDialog
</synopsis>

</refsect1>


<refsect1>
<title>Signal Prototypes</title>
<synopsis>

&quot;<link linkend="GtkInputDialog-disable-device">disable-device</link>&quot;
            void        user_function      (<link linkend="GtkInputDialog">GtkInputDialog</link> *inputdialog,
                                            <link linkend="gint">gint</link> deviceid,
                                            <link linkend="gpointer">gpointer</link> user_data);
&quot;<link linkend="GtkInputDialog-enable-device">enable-device</link>&quot;
            void        user_function      (<link linkend="GtkInputDialog">GtkInputDialog</link> *inputdialog,
                                            <link linkend="gint">gint</link> deviceid,
                                            <link linkend="gpointer">gpointer</link> user_data);
</synopsis>
</refsect1>


<refsect1>
<title>Description</title>
<para>
 NOTE this widget is considered too specialized/little-used for
 GTK+, and will in the future be moved to some other package.  If
 your application needs this widget, feel free to use it, as the
 widget does work and is useful in some applications; it's just not
 of general interest. However, we are not accepting new features for
 the widget, and it will eventually move out of the GTK+
 distribution.
</para>

<para>
<link linkend="GtkInputDialog">GtkInputDialog</link> displays a dialog which allows the user
to configure XInput extension devices. For each
device, they can control the mode of the device
(disabled, screen-relative, or window-relative), 
the mapping of axes to coordinates, and the
mapping of the devices macro keys to key press
events.
</para>
<para>
<link linkend="GtkInputDialog">GtkInputDialog</link> contains two buttons to which
the application can connect; one for closing
the dialog, and one for saving the changes.
No actions are bound to these by default.
The changes that the user makes take effect
immediately. 
</para>
</refsect1>

<refsect1>
<title>Details</title>
<refsect2>
<title><anchor id="GtkInputDialog-struct">struct GtkInputDialog</title>
<programlisting>struct GtkInputDialog;</programlisting>
<para>
</para></refsect2>
<refsect2>
<title><anchor id="gtk-input-dialog-new">gtk_input_dialog_new ()</title>
<programlisting><link linkend="GtkWidget">GtkWidget</link>*  gtk_input_dialog_new            (void);</programlisting>
<para>
Creates a new <link linkend="GtkInputDialog">GtkInputDialog</link>.
</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry>the new <link linkend="GtkInputDialog">GtkInputDialog</link>.


</entry></row>
</tbody></tgroup></informaltable></refsect2>

</refsect1>

<refsect1>
<title>Signals</title>
<refsect2><title><anchor id="GtkInputDialog-disable-device">The &quot;disable-device&quot; signal</title>
<programlisting>void        user_function                  (<link linkend="GtkInputDialog">GtkInputDialog</link> *inputdialog,
                                            <link linkend="gint">gint</link> deviceid,
                                            <link linkend="gpointer">gpointer</link> user_data);</programlisting>
<para>
This signal is emitted when the user changes the 
mode of a device from a <link linkend="GDK-MODE-SCREEN-CAPS">GDK_MODE_SCREEN</link> or <link linkend="GDK-MODE-WINDOW-CAPS">GDK_MODE_WINDOW</link>
to <link linkend="GDK-MODE-ENABLED-CAPS">GDK_MODE_ENABLED</link>.
</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>inputdialog</parameter>&nbsp;:</entry>
<entry>the object which received the signal.
</entry></row>
<row><entry align="right"><parameter>deviceid</parameter>&nbsp;:</entry>
<entry>The ID of the newly disabled device.

</entry></row>
<row><entry align="right"><parameter>user_data</parameter>&nbsp;:</entry>
<entry>user data set when the signal handler was connected.</entry></row>
</tbody></tgroup></informaltable></refsect2><refsect2><title><anchor id="GtkInputDialog-enable-device">The &quot;enable-device&quot; signal</title>
<programlisting>void        user_function                  (<link linkend="GtkInputDialog">GtkInputDialog</link> *inputdialog,
                                            <link linkend="gint">gint</link> deviceid,
                                            <link linkend="gpointer">gpointer</link> user_data);</programlisting>
<para>
This signal is emitted when the user changes the 
mode of a device from <link linkend="GDK-MODE-DISABLED-CAPS">GDK_MODE_DISABLED</link> to a 
<link linkend="GDK-MODE-SCREEN-CAPS">GDK_MODE_SCREEN</link> or <link linkend="GDK-MODE-WINDOW-CAPS">GDK_MODE_WINDOW</link>.
</para><informaltable pgwide="1" frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>inputdialog</parameter>&nbsp;:</entry>
<entry>the object which received the signal.
</entry></row>
<row><entry align="right"><parameter>deviceid</parameter>&nbsp;:</entry>
<entry>The ID of the newly enabled device.

</entry></row>
<row><entry align="right"><parameter>user_data</parameter>&nbsp;:</entry>
<entry>user data set when the signal handler was connected.</entry></row>
</tbody></tgroup></informaltable></refsect2>
</refsect1>



</refentry>
