← Back to branch summary

~ubuntu-branches/ubuntu/precise/gtk+2.0/precise-updates

« back to all changes in this revision

Viewing changes to docs/reference/gdk/tmpl/input.sgml

  • Committer: Package Import Robot
  • Author(s): Ken VanDine
  • Date: 2011-12-01 11:40:06 UTC
  • mfrom: (1.14.11)
  • Revision ID: package-import@ubuntu.com-20111201114006-nrmf6qu3pg512veo
Tags: 2.24.8-0ubuntu1
https://launchpad.net/bugs/189494
https://launchpad.net/bugs/889019
* New upstream release 
  - gtkfilechooser should be more robust to malformed URIs
    in .gtk-bookmarks (LP: #189494)
* debian/patches/010_make_bg_changes_queue_repaint.patch
  - dropped it introduces performance regressions in some gtk2 
    apps (LP: #889019)
* 101_filechooser.patch, 000git_file_chooser.patch: dropped, upstream

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/reference/gdk/tmpl/input.sgml
1
 
<!-- ##### SECTION Title ##### -->
2
 
Input
3
 
 
4
 
<!-- ##### SECTION Short_Description ##### -->
5
 
Callbacks on file descriptors
6
 
 
7
 
<!-- ##### SECTION Long_Description ##### -->
8
 
<para>
9
 
The functions in this section are used to establish
10
 
callbacks when some condition becomes true for
11
 
a file descriptor. They are currently just wrappers around
12
 
the <link linkend="glib-IO-Channels">IO Channel</link>
13
 
facility.
14
 
</para>
15
 
 
16
 
<!-- ##### SECTION See_Also ##### -->
17
 
<para>
18
 
<variablelist>
19
 
 
20
 
<varlistentry>
21
 
<term><link linkend="glib-The-Main-Event-Loop">GLib Main Loop</link></term>
22
 
<listitem><para>The main loop in which input callbacks run.</para></listitem>
23
 
</varlistentry>
24
 
 
25
 
<varlistentry>
26
 
<term><link linkend="glib-IO-Channels">IO Channels</link></term>
27
 
<listitem><para>A newer and more flexible way of doing IO
28
 
callbacks.</para></listitem>
29
 
</varlistentry>
30
 
 
31
 
</variablelist>
32
 
</para>
33
 
 
34
 
<!-- ##### SECTION Stability_Level ##### -->
35
 
 
36
 
 
37
 
<!-- ##### SECTION Image ##### -->
38
 
 
39
 
 
40
 
<!-- ##### FUNCTION gdk_input_add_full ##### -->
41
 
 
42
 
 
43
 
@source: 
44
 
@condition: 
45
 
@function: 
46
 
@data: 
47
 
@destroy: 
48
 
@Returns: 
49
 
 
50
 
 
51
 
<!-- ##### ENUM GdkInputCondition ##### -->
52
 
<para>
53
 
A set of bit flags used to specify conditions for which
54
 
an input callback will be triggered. The three members
55
 
of this enumeration correspond to the @readfds, 
56
 
@writefds, and @exceptfds arguments to the 
57
 
<function>select</function> system call.
58
 
</para>
59
 
 
60
 
@GDK_INPUT_READ: the file descriptor has become available for reading.
61
 
(Or, as is standard in Unix, a socket or pipe was closed
62
 
at the other end; this is the case if a subsequent read
63
 
on the file descriptor returns a count of zero.)
64
 
@GDK_INPUT_WRITE: the file descriptor has become available for writing.
65
 
@GDK_INPUT_EXCEPTION: an exception was raised on the file descriptor.
66
 
 
67
 
<!-- ##### USER_FUNCTION GdkInputFunction ##### -->
68
 
<para>
69
 
A callback function that will be called when some condition
70
 
occurs.
71
 
</para>
72
 
 
73
 
@data: the user data passed to gdk_input_add() or gdk_input_add_full().
74
 
@source: the source where the condition occurred.
75
 
@condition: the triggering condition.
76
 
 
77
 
 
78
 
<!-- ##### USER_FUNCTION GdkDestroyNotify ##### -->
79
 
<para>
80
 
A callback function called when a piece of user data is 
81
 
no longer being stored by GDK. Will typically free the
82
 
structure or object that @data points to.
83
 
</para>
84
 
 
85
 
@data: the user data.
86
 
 
87
 
 
88
 
<!-- ##### FUNCTION gdk_input_add ##### -->
89
 
 
90
 
 
91
 
@source: 
92
 
@condition: 
93
 
@function: 
94
 
@data: 
95
 
@Returns: 
96
 
 
97
 
 
98
 
<!-- ##### FUNCTION gdk_input_remove ##### -->
99
 
<para>
100
 
Remove a callback added with gdk_input_add() or 
101
 
gdk_input_add_full().
102
 
</para>
103
 
 
104
 
@tag: the tag returned when the callback was set up.
105
 
 
106