Input

Name

Input -- Callbacks on file descriptors.

Synopsis


#include <gdk/gdk.h>


gint        gdk_input_add_full              (gint source,
                                             GdkInputCondition condition,
                                             GdkInputFunction function,
                                             gpointer data,
                                             GdkDestroyNotify destroy);
enum        GdkInputCondition;
void        (*GdkInputFunction)             (gpointer data,
                                             gint source,
                                             GdkInputCondition condition);
void        (*GdkDestroyNotify)             (gpointer data);
gint        gdk_input_add                   (gint source,
                                             GdkInputCondition condition,
                                             GdkInputFunction function,
                                             gpointer data);
void        gdk_input_remove                (gint tag);

Description

The functions in this section are used to establish callbacks when some condition becomes true for a file descriptor. They are currently just wrappers around the IO Channel facility.

Details

gdk_input_add_full ()

gint        gdk_input_add_full              (gint source,
                                             GdkInputCondition condition,
                                             GdkInputFunction function,
                                             gpointer data,
                                             GdkDestroyNotify destroy);

Warning

gdk_input_add_full is deprecated and should not be used in newly-written code.

Establish a callback when a condition becomes true on a file descriptor.


enum GdkInputCondition

typedef enum
{
  GDK_INPUT_READ       = 1 << 0,
  GDK_INPUT_WRITE      = 1 << 1,
  GDK_INPUT_EXCEPTION  = 1 << 2
} GdkInputCondition;

A set of bit flags used to specify conditions for which an input callback will be triggered. The three members of this enumeration correspond to the readfds, writefds, and exceptfds arguments to the select system call.


GdkInputFunction ()

void        (*GdkInputFunction)             (gpointer data,
                                             gint source,
                                             GdkInputCondition condition);

A callback function that will be called when some condition occurs.


GdkDestroyNotify ()

void        (*GdkDestroyNotify)             (gpointer data);

A callback function called when a piece of user data is no longer being stored by GDK. Will typically free the structure or object that data points to.


gdk_input_add ()

gint        gdk_input_add                   (gint source,
                                             GdkInputCondition condition,
                                             GdkInputFunction function,
                                             gpointer data);

Warning

gdk_input_add is deprecated and should not be used in newly-written code.

Establish a callback when a condition becomes true on a file descriptor.


gdk_input_remove ()

void        gdk_input_remove                (gint tag);

Warning

gdk_input_remove is deprecated and should not be used in newly-written code.

Remove a callback added with gdk_input_add() or gdk_input_add_full().

See Also

GLib Main Loop

The main loop in which input callbacks run.

IO Channels

A newer and more flexible way of doing IO callbacks.