File: class-gdkdisplay.html

package info (click to toggle)
python-gtk2-doc 2.5.2-1
  • links: PTS
  • area: main
  • in suites: sarge
  • size: 8,304 kB
  • ctags: 3,741
  • sloc: makefile: 38
file content (143 lines) | stat: -rw-r--r-- 50,125 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>gtk.gdk.Display</title><meta name="generator" content="DocBook XSL Stylesheets V1.65.1"><link rel="home" href="index.html" title="PyGTK 2.0 Reference Manual"><link rel="up" href="gdk-class-reference.html" title="The gtk.gdk Class Reference"><link rel="previous" href="class-gdkdevice.html" title="gtk.gdk.Device"><link rel="next" href="class-gdkdisplaymanager.html" title="gtk.gdk.DisplayManager"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">gtk.gdk.Display</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="class-gdkdevice.html">Prev</a></td><th width="60%" align="center">The gtk.gdk Class Reference</th><td width="20%" align="right"><a accesskey="n" href="class-gdkdisplaymanager.html">Next</a></td></tr></table><hr></div><div class="refentry" lang="en"><a name="class-gdkdisplay"></a><div class="titlepage"><div></div><div></div></div><div class="refnamediv"><h2>gtk.gdk.Display</h2><p>gtk.gdk.Display &#8212; controls the keyboard/mouse pointer grabs and a set of <a href="class-gdkscreen.html" title="gtk.gdk.Screen"><tt class="classname">gtk.gdk.Screen</tt></a>
objects</p></div><div class="refsect1" lang="en"><a name="id3158172"></a><h2>Synopsis</h2><table bgcolor="#D0E0F0" width="100%"><tr><td><pre class="classsynopsis">class <span class="ooclass"><span class="classname">gtk.gdk.Display</span></span>(<span class="ooclass"><span class="classname"><a href="class-gobject.html" title="gobject.GObject">gobject.GObject</a></span></span>):
<code class="constructorsynopsis">    <span class="methodname"><a href="class-gdkdisplay.html#constructor-gdkdisplay" title="Constructor">gtk.gdk.Display</a></span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>display_name</tt></b></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a href="class-gdkdisplay.html#method-gdkdisplay--get-name" title="gtk.gdk.Display.get_name">get_name</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a href="class-gdkdisplay.html#method-gdkdisplay--get-n-screens" title="gtk.gdk.Display.get_n_screens">get_n_screens</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a href="class-gdkdisplay.html#method-gdkdisplay--get-screen" title="gtk.gdk.Display.get_screen">get_screen</a></span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>screen_num</tt></b></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a href="class-gdkdisplay.html#method-gdkdisplay--get-default-screen" title="gtk.gdk.Display.get_default_screen">get_default_screen</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a href="class-gdkdisplay.html#method-gdkdisplay--pointer-ungrab" title="gtk.gdk.Display.pointer_ungrab">pointer_ungrab</a></span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>time_</tt></b></span><span class="initializer">=0L</span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a href="class-gdkdisplay.html#method-gdkdisplay--keyboard-ungrab" title="gtk.gdk.Display.keyboard_ungrab">keyboard_ungrab</a></span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>time_</tt></b></span><span class="initializer">=0L</span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a href="class-gdkdisplay.html#method-gdkdisplay--pointer-is-grabbed" title="gtk.gdk.Display.pointer_is_grabbed">pointer_is_grabbed</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a href="class-gdkdisplay.html#method-gdkdisplay--beep" title="gtk.gdk.Display.beep">beep</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a href="class-gdkdisplay.html#method-gdkdisplay--sync" title="gtk.gdk.Display.sync">sync</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a href="class-gdkdisplay.html#method-gdkdisplay--close" title="gtk.gdk.Display.close">close</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a href="class-gdkdisplay.html#method-gdkdisplay--list-devices" title="gtk.gdk.Display.list_devices">list_devices</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a href="class-gdkdisplay.html#method-gdkdisplay--get-event" title="gtk.gdk.Display.get_event">get_event</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a href="class-gdkdisplay.html#method-gdkdisplay--peek-event" title="gtk.gdk.Display.peek_event">peek_event</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a href="class-gdkdisplay.html#method-gdkdisplay--put-event" title="gtk.gdk.Display.put_event">put_event</a></span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>event</tt></b></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a href="class-gdkdisplay.html#method-gdkdisplay--set-double-click-time" title="gtk.gdk.Display.set_double_click_time">set_double_click_time</a></span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>msec</tt></b></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a href="class-gdkdisplay.html#method-gdkdisplay--get-core-pointer" title="gtk.gdk.Display.get_core_pointer">get_core_pointer</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a href="class-gdkdisplay.html#method-gdkdisplay--get-pointer" title="gtk.gdk.Display.get_pointer">get_pointer</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a href="class-gdkdisplay.html#method-gdkdisplay--get-window-at-pointer" title="gtk.gdk.Display.get_window_at_pointer">get_window_at_pointer</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a href="class-gdkdisplay.html#method-gdkdisplay--flush" title="gtk.gdk.Display.flush">flush</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a href="class-gdkdisplay.html#method-gdkdisplay--set-double-click-distance" title="gtk.gdk.Display.set_double_click_distance">set_double_click_distance</a></span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>distance</tt></b></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a href="class-gdkdisplay.html#method-gdkdisplay--supports-cursor-alpha" title="gtk.gdk.Display.supports_cursor_alpha">supports_cursor_alpha</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a href="class-gdkdisplay.html#method-gdkdisplay--supports-cursor-color" title="gtk.gdk.Display.supports_cursor_color">supports_cursor_color</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a href="class-gdkdisplay.html#method-gdkdisplay--get-default-cursor-size" title="gtk.gdk.Display.get_default_cursor_size">get_default_cursor_size</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a href="class-gdkdisplay.html#method-gdkdisplay--get-maximal-cursor-size" title="gtk.gdk.Display.get_maximal_cursor_size">get_maximal_cursor_size</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a href="class-gdkdisplay.html#method-gdkdisplay--get-default-group" title="gtk.gdk.Display.get_default_group">get_default_group</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a href="class-gdkdisplay.html#method-gdkdisplay--supports-selection-notification" title="gtk.gdk.Display.supports_selection_notification">supports_selection_notification</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a href="class-gdkdisplay.html#method-gdkdisplay--supports-clipboard-persistence" title="gtk.gdk.Display.supports_clipboard_persistence">supports_clipboard_persistence</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a href="class-gdkdisplay.html#method-gdkdisplay--request-selection-notification" title="gtk.gdk.Display.request_selection_notification">request_selection_notification</a></span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>selection</tt></b></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a href="class-gdkdisplay.html#method-gdkdisplay--store-clipboard" title="gtk.gdk.Display.store_clipboard">store_clipboard</a></span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>clipboard_window</tt></b></span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>time_</tt></b></span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>targets</tt></b></span></span>)</code><br></pre></td></tr></table><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting">
<span class="bold"><b>Functions</b></span>

<code class="methodsynopsis">    def <span class="methodname"><a href="class-gdkdisplay.html#function-gdk--display-get-default" title="gtk.gdk.display_get_default">gtk.gdk.display_get_default</a></span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt></tt></b></span></span>)</code></pre></td></tr></table></div><div class="refsect1" lang="en"><a name="id3210431"></a><h2>Ancestry</h2><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="synopsis">+-- <a href="class-gobject.html" title="gobject.GObject">gobject.GObject</a>
  +-- <a href="class-gdkdisplay.html" title="gtk.gdk.Display">gtk.gdk.Display</a>
</pre></td></tr></table></div><div class="refsect1" lang="en"><a name="id3158112"></a><h2>Signal Prototypes</h2><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term">"<a href="class-gdkdisplay.html#signal-gdkdisplay--closed" title='The "closed" gtk.gdk.Display Signal'>closed</a>"</span></td><td><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><i class="parameter"><tt>widget</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>is_error</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>user_param1</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>...</tt></i></span></span>)</code></td></tr></tbody></table></div><div class="refsect1" lang="en"><a name="id3182047"></a><h2>Description</h2><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This object is available in PyGTK 2.2 and above.</p></div><p><a href="class-gdkdisplay.html" title="gtk.gdk.Display"><tt class="classname">gtk.gdk.Display</tt></a> objects provide two capabilities:</p><div class="itemizedlist"><ul type="disc"><li>To grab/ungrab keyboard focus and mouse pointer</li><li>To manage and provide information about the <a href="class-gdkscreen.html" title="gtk.gdk.Screen"><tt class="classname">gtk.gdk.Screen</tt></a>)
	objects available for this <a href="class-gdkdisplay.html" title="gtk.gdk.Display"><tt class="classname">gtk.gdk.Display</tt></a></li></ul></div><p><a href="class-gdkdisplay.html" title="gtk.gdk.Display"><tt class="classname">gtk.gdk.Display</tt></a>
objects are the <tt class="literal">GDK</tt> representation of the X Display which
can be described as a workstation consisting of a keyboard, a pointing
device (such as a mouse) and one or more screens. It is used to open and
keep track of various <a href="class-gdkscreen.html" title="gtk.gdk.Screen"><tt class="classname">gtk.gdk.Screen</tt></a>
objects currently instantiated by the application. It is also used to grab
and release the keyboard and the mouse pointer.</p></div><div class="refsect1" lang="en"><a name="constructor-gdkdisplay"></a><h2>Constructor</h2><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="constructorsynopsis">    <span class="methodname">gtk.gdk.Display</span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>display_name</tt></b></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><b class="parameter"><tt>display_name</tt></b>:</span></td><td>the name of the display to
      open</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td>a
      <a href="class-gdkdisplay.html" title="gtk.gdk.Display"><tt class="classname">gtk.gdk.Display</tt></a>,
      or <tt class="literal">None</tt> if the display could not be
      opened.</td></tr></tbody></table><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This constructor is available in PyGTK 2.2 and above.</p></div><p>Opens the display with the name specified by
<i class="parameter"><tt>display_name</tt></i> and returns a <a href="class-gdkdisplay.html" title="gtk.gdk.Display"><tt class="classname">gtk.gdk.Display</tt></a>
object wrapping the display..</p></div><div class="refsect1" lang="en"><a name="id2946992"></a><h2>Methods</h2><div class="refsect2" lang="en"><a name="method-gdkdisplay--get-name"></a><h3>gtk.gdk.Display.get_name</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_name</span>(<span class="methodparam"></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td>a
      string representing the display name.</td></tr></tbody></table><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.2 and above.</p></div><p>The <tt class="methodname">get_name</tt>() method returns the name
of the display.</p></div><div class="refsect2" lang="en"><a name="method-gdkdisplay--get-n-screens"></a><h3>gtk.gdk.Display.get_n_screens</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_n_screens</span>(<span class="methodparam"></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td>the number of display
	  screens.</td></tr></tbody></table><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.2 and above.</p></div><p>The <tt class="methodname">get_n_screens</tt>() method returns the
number of screens managed by the display.</p></div><div class="refsect2" lang="en"><a name="method-gdkdisplay--get-screen"></a><h3>gtk.gdk.Display.get_screen</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_screen</span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>screen_num</tt></b></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><b class="parameter"><tt>screen_num</tt></b>:</span></td><td>the screen number</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td>the <a href="class-gdkscreen.html" title="gtk.gdk.Screen"><tt class="classname">gtk.gdk.Screen</tt></a>
	  object</td></tr></tbody></table><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.2 and above.</p></div><p>The <tt class="methodname">get_screen</tt>() method returns a <a href="class-gdkscreen.html" title="gtk.gdk.Screen"><tt class="classname">gtk.gdk.Screen</tt></a>
object for one of the screens of the display.</p></div><div class="refsect2" lang="en"><a name="method-gdkdisplay--get-default-screen"></a><h3>gtk.gdk.Display.get_default_screen</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_default_screen</span>(<span class="methodparam"></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td>the default <a href="class-gdkscreen.html" title="gtk.gdk.Screen"><tt class="classname">gtk.gdk.Screen</tt></a>
	  object for <i class="parameter"><tt>display</tt></i></td></tr></tbody></table><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.2 and above.</p></div><p>The <tt class="methodname">get_default_screen</tt>() method returns
the default <a href="class-gdkscreen.html" title="gtk.gdk.Screen"><tt class="classname">gtk.gdk.Screen</tt></a> for
the display</p></div><div class="refsect2" lang="en"><a name="method-gdkdisplay--pointer-ungrab"></a><h3>gtk.gdk.Display.pointer_ungrab</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">pointer_ungrab</span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>time_</tt></b></span><span class="initializer">=0L</span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><b class="parameter"><tt>time_</tt></b>:</span></td><td>a timestamp or 0L for the current
	  time.</td></tr></tbody></table><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.2 and above.</p></div><p>The <tt class="methodname">pointer_ungrab</tt>() method releases
any pointer grab held by the display.</p></div><div class="refsect2" lang="en"><a name="method-gdkdisplay--keyboard-ungrab"></a><h3>gtk.gdk.Display.keyboard_ungrab</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">keyboard_ungrab</span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>time_</tt></b></span><span class="initializer">=0L</span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><b class="parameter"><tt>time_</tt></b>:</span></td><td>a timestamp or 0L for the current
	  time.</td></tr></tbody></table><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.2 and above.</p></div><p>The <tt class="methodname">keyboard_ungrab</tt>() method 
releases any keyboard grab held by the display.</p></div><div class="refsect2" lang="en"><a name="method-gdkdisplay--pointer-is-grabbed"></a><h3>gtk.gdk.Display.pointer_is_grabbed</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">pointer_is_grabbed</span>(<span class="methodparam"></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td><tt class="literal">TRUE</tt> if an active X pointer
	  grab is in effect</td></tr></tbody></table><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.2 and above.</p></div><p>The <tt class="methodname">pointer_is_grabbed</tt>() method returns
<tt class="literal">TRUE</tt> if the pointer is grabbed.</p></div><div class="refsect2" lang="en"><a name="method-gdkdisplay--beep"></a><h3>gtk.gdk.Display.beep</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">beep</span>(<span class="methodparam"></span>)</code></pre></td></tr></table><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.2 and above.</p></div><p>The <tt class="methodname">beep</tt>() method 
emits a short beep on the display.</p></div><div class="refsect2" lang="en"><a name="method-gdkdisplay--sync"></a><h3>gtk.gdk.Display.sync</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">sync</span>(<span class="methodparam"></span>)</code></pre></td></tr></table><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.2 and above.</p></div><p>The <tt class="methodname">sync</tt>() method flushes any requests
queued for the windowing system and waits until all requests have been
handled. This is often used for making sure that the display is synchronized
with the current state of the program. This is most useful for X11. On
windowing systems where requests are handled synchronously, this method will
do nothing.</p></div><div class="refsect2" lang="en"><a name="method-gdkdisplay--close"></a><h3>gtk.gdk.Display.close</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">close</span>(<span class="methodparam"></span>)</code></pre></td></tr></table><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.2 and above.</p></div><p>The <tt class="methodname">close</tt>() method closes the
connection to the windowing system for the given display, and cleans up
associated resources.</p></div><div class="refsect2" lang="en"><a name="method-gdkdisplay--list-devices"></a><h3>gtk.gdk.Display.list_devices</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">list_devices</span>(<span class="methodparam"></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td>a list of <a href="class-gdkdevice.html" title="gtk.gdk.Device"><tt class="classname">gtk.gdk.Device</tt></a>
	  objects.</td></tr></tbody></table><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.2 and above.</p></div><p>The <tt class="methodname">list_devices</tt>() method returns the
list of available input devices attached to the display.</p></div><div class="refsect2" lang="en"><a name="method-gdkdisplay--get-event"></a><h3>gtk.gdk.Display.get_event</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_event</span>(<span class="methodparam"></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td>the next <a href="class-gdkevent.html" title="gtk.gdk.Event"><tt class="classname">gtk.gdk.Event</tt></a>
	  to be processed, or <tt class="literal">None</tt> if no events are
	  pending..</td></tr></tbody></table><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.2 and above.</p></div><p>The <tt class="methodname">get_event</tt>() method returns the next
<a href="class-gdkevent.html" title="gtk.gdk.Event"><tt class="classname">gtk.gdk.Event</tt></a>
to be processed for the display, fetching events from the windowing system
if necessary. The returned <a href="class-gdkevent.html" title="gtk.gdk.Event"><tt class="classname">gtk.gdk.Event</tt></a> should
be freed with the <a href="class-gdkevent.html#method-gdkevent--free" title="gtk.gdk.Event.free"><tt class="methodname">gtk.gdk.Event.free()</tt></a>
method </p></div><div class="refsect2" lang="en"><a name="method-gdkdisplay--peek-event"></a><h3>gtk.gdk.Display.peek_event</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">peek_event</span>(<span class="methodparam"></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td>a copy of the first <a href="class-gdkevent.html" title="gtk.gdk.Event"><tt class="classname">gtk.gdk.Event</tt></a>
	  on the event queue, or <tt class="literal">None</tt> if no events are in
	  the queue.</td></tr></tbody></table><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.2 and above.</p></div><p>The <tt class="methodname">peek_event</tt>() method returns a copy
of the first <a href="class-gdkevent.html" title="gtk.gdk.Event"><tt class="classname">gtk.gdk.Event</tt></a> in the
the display's event queue, without removing the event from the queue.  (Note
that this method will not get more events from the windowing system. It only
checks the events that have already been moved to the <tt class="literal">GDK</tt>
event queue.)  The returned <a href="class-gdkevent.html" title="gtk.gdk.Event"><tt class="classname">gtk.gdk.Event</tt></a> should
be freed with <a href="class-gdkevent.html#method-gdkevent--free" title="gtk.gdk.Event.free"><tt class="methodname">gtk.gdk.Event.free()</tt></a>.</p></div><div class="refsect2" lang="en"><a name="method-gdkdisplay--put-event"></a><h3>gtk.gdk.Display.put_event</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">put_event</span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>event</tt></b></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><b class="parameter"><tt>event</tt></b>:</span></td><td>a <a href="class-gdkevent.html" title="gtk.gdk.Event"><tt class="classname">gtk.gdk.Event</tt></a>.</td></tr></tbody></table><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.2 and above.</p></div><p>The <tt class="methodname">put_event</tt>() method appends a copy
of the given event onto the front of the event queue for the display.</p></div><div class="refsect2" lang="en"><a name="method-gdkdisplay--set-double-click-time"></a><h3>gtk.gdk.Display.set_double_click_time</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_double_click_time</span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>msec</tt></b></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><b class="parameter"><tt>msec</tt></b>:</span></td><td>the double click time in milliseconds
	  (thousandths of a second)</td></tr></tbody></table><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.2 and above.</p></div><p>The <tt class="methodname">set_double_click_time</tt>() method sets
the double click time (two clicks within this time interval count as a
double click and result in a <tt class="literal">gtk.gdk._2BUTTON_PRESS</tt>
event).  Applications should <span class="emphasis"><em>not</em></span> set this, it is a
global user-configured setting.</p></div><div class="refsect2" lang="en"><a name="method-gdkdisplay--get-core-pointer"></a><h3>gtk.gdk.Display.get_core_pointer</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_core_pointer</span>(<span class="methodparam"></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td>the core pointer device</td></tr></tbody></table><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.2 and above.</p></div><p>The <tt class="methodname">get_core_pointer</tt>() method returns
the core pointer device for the given display</p></div><div class="refsect2" lang="en"><a name="method-gdkdisplay--get-pointer"></a><h3>gtk.gdk.Display.get_pointer</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_pointer</span>()</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td>a 4-tuple containing the screen that the cursor
	  is on, the root window X and Y coordinates of the pointer and the
	  current modifier mask</td></tr></tbody></table><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.2 and above.</p></div><p>The <tt class="methodname">get_pointer</tt>() method returns a
4-tuple containing the <a href="class-gdkscreen.html" title="gtk.gdk.Screen"><tt class="classname">gtk.gdk.Screen</tt></a> that
the pointer is on, the current location coordinates of the pointer and the
current modifier mask for the display. The returned modifier mask is a
combination of the <a href="gdk-constants.html#gdk-modifier-constants">GDK Modifier Constants</a>.</p></div><div class="refsect2" lang="en"><a name="method-gdkdisplay--get-window-at-pointer"></a><h3>gtk.gdk.Display.get_window_at_pointer</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_window_at_pointer</span>()</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td>a 3-tuple containing the <a href="class-gdkwindow.html" title="gtk.gdk.Window"><tt class="classname">gtk.gdk.Window</tt></a>
	  under the mouse pointer and the x and y coordinates of the window
	  origin</td></tr></tbody></table><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.2 and above.</p></div><p>The <tt class="methodname">get_window_at_pointer</tt>() method
returns a 3-tuple containing the <a href="class-gdkwindow.html" title="gtk.gdk.Window"><tt class="classname">gtk.gdk.Window</tt></a>
underneath the mouse pointer and the location of that window's
origin. Returns <tt class="literal">None</tt> if the window under the mouse
pointer is not known to <tt class="literal">GDK</tt> (for example, belongs to
another application).</p></div><div class="refsect2" lang="en"><a name="method-gdkdisplay--flush"></a><h3>gtk.gdk.Display.flush</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">flush</span>(<span class="methodparam"></span>)</code></pre></td></tr></table><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.4 and above.</p></div><p>The <tt class="methodname">flush</tt>() method flushes any requests
queued for the windowing system; this happens automatically when the main
loop blocks waiting for new events, but if your application is drawing
without returning control to the main loop, you may need to call this method
explicitly. A common case where this method needs to be called is when an
application is executing drawing commands from a thread other than the
thread where the main loop is running.</p><p>This is most useful for X11. On windowing systems where requests
are handled synchronously, this method will do nothing.</p></div><div class="refsect2" lang="en"><a name="method-gdkdisplay--set-double-click-distance"></a><h3>gtk.gdk.Display.set_double_click_distance</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_double_click_distance</span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>distance</tt></b></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><b class="parameter"><tt>distance</tt></b>:</span></td><td>the distance in pixels</td></tr></tbody></table><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.4 and above.</p></div><p>The <tt class="methodname">set_double_click_distance</tt>() method
sets the double click distance (two clicks within this distance count as a
double click and result in a <tt class="literal">gtk.gdk.2BUTTON_PRESS</tt>
event).  See the <a href="class-gdkdisplay.html#method-gdkdisplay--set-double-click-time" title="gtk.gdk.Display.set_double_click_time"><tt class="methodname">set_double_click_time()</tt></a>
method for more information.  Applications should <span class="emphasis"><em>not</em></span>
set this, it is a global user-configured setting.</p></div><div class="refsect2" lang="en"><a name="method-gdkdisplay--supports-cursor-alpha"></a><h3>gtk.gdk.Display.supports_cursor_alpha</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">supports_cursor_alpha</span>(<span class="methodparam"></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td><tt class="literal">TRUE</tt> if cursors can have
	  alpha channels.</td></tr></tbody></table><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.4 and above.</p></div><p>The <tt class="methodname">supports_cursor_alpha</tt>() method
returns <tt class="literal">TRUE</tt> if cursors can use an 8bit alpha channel on
the display. Otherwise, cursors are restricted to bilevel alpha (i.e. a
mask).</p></div><div class="refsect2" lang="en"><a name="method-gdkdisplay--supports-cursor-color"></a><h3>gtk.gdk.Display.supports_cursor_color</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">supports_cursor_color</span>(<span class="methodparam"></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td><tt class="literal">TRUE</tt> if cursors can have
	  multiple colors.</td></tr></tbody></table><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.4 and above.</p></div><p>The <tt class="methodname">supports_cursor_color</tt>() method
returns <tt class="literal">TRUE</tt> if multicolored cursors are supported on the
display. Otherwise, cursors have only a foreground and a background
color.</p></div><div class="refsect2" lang="en"><a name="method-gdkdisplay--get-default-cursor-size"></a><h3>gtk.gdk.Display.get_default_cursor_size</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_default_cursor_size</span>(<span class="methodparam"></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td>the default cursor size.</td></tr></tbody></table><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.4 and above.</p></div><p>The <tt class="methodname">get_default_cursor_size</tt>() method
returns the default size to use for cursors on the display.</p></div><div class="refsect2" lang="en"><a name="method-gdkdisplay--get-maximal-cursor-size"></a><h3>gtk.gdk.Display.get_maximal_cursor_size</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_maximal_cursor_size</span>()</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td>a 2-tuple containing the maximal cursor width
	  and height</td></tr></tbody></table><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.4 and above.</p></div><p>The <tt class="methodname">get_maximal_cursor_size</tt>() method
returns a 2-tuple containing the maximum width and height to use for cursors
on the display.</p></div><div class="refsect2" lang="en"><a name="method-gdkdisplay--get-default-group"></a><h3>gtk.gdk.Display.get_default_group</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_default_group</span>(<span class="methodparam"></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td>The default group leader window for the
	  display</td></tr></tbody></table><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.4 and above.</p></div><p>The <tt class="methodname">get_default_group</tt>() method returns
the default group leader window for all toplevel windows on the
display. This window is implicitly created by <tt class="literal">GDK</tt>.  See
the <a href="class-gdkwindow.html#method-gdkwindow--set-group" title="gtk.gdk.Window.set_group"><tt class="methodname">gtk.gdk.Window.set_group()</tt></a>
method for more information.</p></div><div class="refsect2" lang="en"><a name="method-gdkdisplay--supports-selection-notification"></a><h3>gtk.gdk.Display.supports_selection_notification</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_default_group</span>(<span class="methodparam"></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td><tt class="literal">TRUE</tt> if
<tt class="literal">gtk.gdk.EventOwnerChange</tt> events will be
sent.</td></tr></tbody></table><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.6 and above.</p></div><p>The <tt class="methodname">supports_selection_notification</tt>()
method returns <tt class="literal">TRUE</tt> if
<tt class="literal">gtk.gdk.EventOwnerChange</tt> events will be sent when the
owner of a selection changes.</p></div><div class="refsect2" lang="en"><a name="method-gdkdisplay--supports-clipboard-persistence"></a><h3>gtk.gdk.Display.supports_clipboard_persistence</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">supports_clipboard_persistence</span>(<span class="methodparam"></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td><tt class="literal">TRUE</tt> if the display
supports clipboard persistence.</td></tr></tbody></table><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.6 and above.</p></div><p>The <tt class="methodname">supports_clipboard_persistence</tt>()
method Returns whether the specified display supports clipboard persistence;
i.e. if it's possible to store the clipboard data after an application has
quit. On X11 this checks if a clipboard daemon is running.</p></div><div class="refsect2" lang="en"><a name="method-gdkdisplay--request-selection-notification"></a><h3>gtk.gdk.Display.request_selection_notification</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">request_selection_notification</span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>selection</tt></b></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><b class="parameter"><tt>selection</tt></b>:</span></td><td>The string (or <a href="class-gdkatom.html" title="gtk.gdk.Atom"><tt class="classname">gtk.gdk.Atom</tt></a>) naming
the selection for which ownership change notification is
requested</td></tr></tbody></table><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.6 and above.</p></div><p>The <tt class="methodname">request_selection_notification</tt>()
method requests that <tt class="literal">gtk.gdk.EventOwnerChange</tt> events will
be sent for changes in ownership of the atom specified by
<i class="parameter"><tt>selection</tt></i>.</p></div><div class="refsect2" lang="en"><a name="method-gdkdisplay--store-clipboard"></a><h3>gtk.gdk.Display.store_clipboard</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">store_clipboard</span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>clipboard_window</tt></b></span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>time</tt></b></span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>targets</tt></b></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><b class="parameter"><tt>clipboard_window</tt></b>:</span></td><td> a <a href="class-gdkwindow.html" title="gtk.gdk.Window"><tt class="classname">gtk.gdk.Window</tt></a>
belonging to the clipboard owner</td></tr><tr><td><span class="term"><b class="parameter"><tt>time</tt></b>:</span></td><td>a timestamp</td></tr><tr><td><span class="term"><b class="parameter"><tt>targets</tt></b>:</span></td><td>a list of targets that should be saved, or
<tt class="literal">None</tt> if all available targets should be
saved.</td></tr></tbody></table><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.6 and above.</p></div><p>The <tt class="methodname">store_clipboard</tt>() method issues a
request to the the clipboard manager to store the clipboard data. On X11,
this is a special program that works according to the freedesktop clipboard
specification, available at <a href="http://www.freedesktop.org/Standards/clipboard-manager-spec" target="_top">http://www.freedesktop.org/Standards/clipboard-manager-spec</a>.</p></div></div><div class="refsect1" lang="en"><a name="id2950147"></a><h2>Functions</h2><div class="refsect2" lang="en"><a name="function-gdk--display-get-default"></a><h3>gtk.gdk.display_get_default</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">gtk.gdk.display_get_default</span>()</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td>a <a href="class-gdkdisplay.html" title="gtk.gdk.Display"><tt class="classname">gtk.gdk.Display</tt></a>,
	  or <tt class="literal">None</tt> if there is no default
	  display.</td></tr></tbody></table><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This function is available in PyGTK 2.2 and above.</p></div><p>The <tt class="function">gtk.gdk.display_get_default</tt>() function
returns the default <a href="class-gdkdisplay.html" title="gtk.gdk.Display"><tt class="classname">gtk.gdk.Display</tt></a>. This
is a convenience function for:</p><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting">
  display_manager = gtk.gdk.display_manager_get()
  display = display.manager.get_default_display()
</pre></td></tr></table></div></div><div class="refsect1" lang="en"><a name="id3068281"></a><h2>Signals</h2><div class="refsect2" lang="en"><a name="signal-gdkdisplay--closed"></a><h3>The "closed" gtk.gdk.Display Signal</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><i class="parameter"><tt>display</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>is_error</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>user_param1</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>...</tt></i></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><i class="parameter"><tt>display</tt></i>:</span></td><td>the display that received the
signal</td></tr><tr><td><span class="term"><i class="parameter"><tt>is_error</tt></i>:</span></td><td><tt class="literal">TRUE</tt> if the display was
	  closed due to an error</td></tr><tr><td><span class="term"><i class="parameter"><tt>user_param1</tt></i>:</span></td><td>the first user parameter (if any) specified
with the <a href="class-gobject.html#method-gobject--connect" title="gobject.GObject.connect"><tt class="methodname">connect</tt>()</a>
method</td></tr><tr><td><span class="term"><i class="parameter"><tt>...</tt></i>:</span></td><td>additional user parameters (if
any)</td></tr></tbody></table><p>The "closed" signal is emitted when the connection to the
windowing system for <i class="parameter"><tt>display</tt></i> is closed.</p></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="class-gdkdevice.html">Prev</a></td><td width="20%" align="center"><a accesskey="u" href="gdk-class-reference.html">Up</a></td><td width="40%" align="right"><a accesskey="n" href="class-gdkdisplaymanager.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">gtk.gdk.Device</td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top">gtk.gdk.DisplayManager</td></tr></table></div></body></html>