GTK+ Reference Manual
<<< Previous Page | Home | Up | Next Page >>>

# GtkInputDialog

## Name

GtkInputDialog -- Configure devices for the XInput extension.

## Synopsis

    #include <gtk/gtk.h>

    struct      GtkInputDialog;
    GtkWidget*  gtk_input_dialog_new            (void);

## Object Hierarchy

      GtkObject
       +----GtkWidget
             +----GtkContainer
                   +----GtkBin
                         +----GtkWindow
                               +----GtkDialog
                                     +----GtkInputDialog

## Signal Prototypes

    "enable-device"
                void        user_function      (GtkInputDialog *inputdialog,
                                                gint deviceid,
                                                gpointer user_data);
    "disable-device"
                void        user_function      (GtkInputDialog *inputdialog,
                                                gint deviceid,
                                                gpointer user_data);

## Description

GtkInputDialog 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.

GtkInputDialog 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.

## Details

### struct GtkInputDialog

    struct GtkInputDialog;

### gtk_input_dialog_new ()

    GtkWidget*  gtk_input_dialog_new            (void);

Creates a new GtkInputDialog.

Returns : | the new GtkInputDialog.

## Signals

### The "enable-device" signal

    void        user_function                  (GtkInputDialog *inputdialog,
                                                gint deviceid,
                                                gpointer user_data);

This signal is emitted when the user changes the mode of a device from GDK_MODE_DISABLED to a GDK_MODE_SCREEN or GDK_MODE_WINDOW.

`inputdialog` : | the object which received the signal.
`deviceid` : | The ID of the newly enabled device.
`user_data` : | user data set when the signal handler was connected.

### The "disable-device" signal

    void        user_function                  (GtkInputDialog *inputdialog,
                                                gint deviceid,
                                                gpointer user_data);

This signal is emitted when the user changes the mode of a device from a GDK_MODE_SCREEN or GDK_MODE_WINDOW to GDK_MODE_ENABLED.

`inputdialog` : | the object which received the signal.
`deviceid` : | The ID of the newly disabled device.
`user_data` : | user data set when the signal handler was connected.

<<< Previous Page | Home | Up | Next Page >>>
GtkImage | GtkInvisible