/usr/share/gtk-doc/html/pygtk/class-gdkscreen.html is in python-gtk2-doc 2.24.0-5.1ubuntu2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
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 144 145 146 147 148 149 150 151 152 153 154 155 156 | <html><head><meta http-equiv="Content-Type" content="text/html; charset=utf-8"><title>gtk.gdk.Screen</title><link rel="stylesheet" href="style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><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="prev" href="class-gdkregion.html" title="gtk.gdk.Region"><link rel="next" href="class-gdkvisual.html" title="gtk.gdk.Visual"></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.Screen</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="class-gdkregion.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-gdkvisual.html">Next</a></td></tr></table><hr></div><div class="refentry" title="gtk.gdk.Screen"><a name="class-gdkscreen"></a><div class="titlepage"></div><div class="refnamediv"><h2>gtk.gdk.Screen</h2><p>gtk.gdk.Screen — an object representing a physical screen</p></div><div class="refsect1" title="Synopsis"><a name="id3076241"></a><h2>Synopsis</h2><table bgcolor="#D0E0F0" width="100%"><tr><td><pre class="classsynopsis">class <span class="ooclass"><span class="classname">gtk.gdk.Screen</span></span>(<span class="ooclass"><span class="classname"><PYGTKDOCLINK HREF="class-gobject">gobject.GObject</PYGTKDOCLINK></span></span>):
<code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gdkscreen.html#method-gdkscreen--get-default-colormap" title="gtk.gdk.Screen.get_default_colormap">get_default_colormap</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gdkscreen.html#method-gdkscreen--set-default-colormap" title="gtk.gdk.Screen.set_default_colormap">set_default_colormap</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>colormap</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gdkscreen.html#method-gdkscreen--get-system-colormap" title="gtk.gdk.Screen.get_system_colormap">get_system_colormap</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gdkscreen.html#method-gdkscreen--get-system-visual" title="gtk.gdk.Screen.get_system_visual">get_system_visual</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gdkscreen.html#method-gdkscreen--get-rgb-colormap" title="gtk.gdk.Screen.get_rgb_colormap">get_rgb_colormap</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gdkscreen.html#method-gdkscreen--get-rgb-visual" title="gtk.gdk.Screen.get_rgb_visual">get_rgb_visual</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gdkscreen.html#method-gdkscreen--get-root-window" title="gtk.gdk.Screen.get_root_window">get_root_window</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gdkscreen.html#method-gdkscreen--get-display" title="gtk.gdk.Screen.get_display">get_display</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gdkscreen.html#method-gdkscreen--get-number" title="gtk.gdk.Screen.get_number">get_number</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gdkscreen.html#method-gdkscreen--get-width" title="gtk.gdk.Screen.get_width">get_width</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gdkscreen.html#method-gdkscreen--get-height" title="gtk.gdk.Screen.get_height">get_height</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gdkscreen.html#method-gdkscreen--get-width-mm" title="gtk.gdk.Screen.get_width_mm">get_width_mm</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gdkscreen.html#method-gdkscreen--get-height-mm" title="gtk.gdk.Screen.get_height_mm">get_height_mm</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gdkscreen.html#method-gdkscreen--list-visuals" title="gtk.gdk.Screen.list_visuals">list_visuals</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gdkscreen.html#method-gdkscreen--get-toplevel-windows" title="gtk.gdk.Screen.get_toplevel_windows">get_toplevel_windows</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gdkscreen.html#method-gdkscreen--make-display-name" title="gtk.gdk.Screen.make_display_name">make_display_name</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gdkscreen.html#method-gdkscreen--get-n-monitors" title="gtk.gdk.Screen.get_n_monitors">get_n_monitors</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gdkscreen.html#method-gdkscreen--get-monitor-geometry" title="gtk.gdk.Screen.get_monitor_geometry">get_monitor_geometry</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>monitor_num</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gdkscreen.html#method-gdkscreen--get-monitor-at-point" title="gtk.gdk.Screen.get_monitor_at_point">get_monitor_at_point</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>x</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>y</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gdkscreen.html#method-gdkscreen--get-monitor-at-window" title="gtk.gdk.Screen.get_monitor_at_window">get_monitor_at_window</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>window</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gdkscreen.html#method-gdkscreen--broadcast-client-message" title="gtk.gdk.Screen.broadcast_client_message">broadcast_client_message</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>event</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gdkscreen.html#method-gdkscreen--get-setting" title="gtk.gdk.Screen.get_setting">get_setting</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>name</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gdkscreen.html#method-gdkscreen--get-rgba-colormap" title="gtk.gdk.Screen.get_rgba_colormap">get_rgba_colormap</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gdkscreen.html#method-gdkscreen--get-rgba-visual" title="gtk.gdk.Screen.get_rgba_visual">get_rgba_visual</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gdkscreen.html#method-gdkscreen--get-monitor-height-mm" title="gtk.gdk.Screen.get_monitor_height_mm">get_monitor_height_mm</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>monitor_num</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gdkscreen.html#method-gdkscreen--get-monitor-width-mm" title="gtk.gdk.Screen.get_monitor_width_mm">get_monitor_width_mm</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>monitor_num</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gdkscreen.html#method-gdkscreen--get-monitor-plug-name" title="gtk.gdk.Screen.get_monitor_plug_name">get_monitor_plug_name</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>monitor_num</code></strong></span></span>)</code><br></pre></td></tr></table><pre class="programlisting">
<span class="bold"><strong>Functions</strong></span>
<code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gdkscreen.html#function-gdk--screen-width" title="gtk.gdk.screen_width">gtk.gdk.screen_width</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code></code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gdkscreen.html#function-gdk--screen-height" title="gtk.gdk.screen_height">gtk.gdk.screen_height</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code></code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gdkscreen.html#function-gdk--screen-width-mm" title="gtk.gdk.screen_width_mm">gtk.gdk.screen_width_mm</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code></code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gdkscreen.html#function-gdk--screen-height-mm" title="gtk.gdk.screen_height_mm">gtk.gdk.screen_height_mm</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code></code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gdkscreen.html#function-gdk--screen-get-default" title="gtk.gdk.screen_get_default">gtk.gdk.screen_get_default</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code></code></strong></span></span>)</code></pre></div><div class="refsect1" title="Ancestry"><a name="id3077009"></a><h2>Ancestry</h2><pre class="synopsis">+-- <PYGTKDOCLINK HREF="class-gobject">gobject.GObject</PYGTKDOCLINK>
+-- <a class="link" href="class-gdkscreen.html" title="gtk.gdk.Screen">gtk.gdk.Screen</a>
</pre></div><div class="refsect1" title="Signal Prototypes"><a name="id3077035"></a><h2>Signal Prototypes</h2><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term">"<a class="link" href="class-gdkscreen.html#signal-gdkscreen--size-changed" title='The "size-changed" gtk.gdk.Screen Signal'>size-changed</a>"</span></p></td><td><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>screen</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr></tbody></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term">"<PYGTKDOCLINK HREF="signal-gdkscreen--monitors-changed">monitors-changed</PYGTKDOCLINK>"</span></p></td><td><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>screen</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr></tbody></table></div><div class="refsect1" title="Description"><a name="id3077172"></a><h2>Description</h2><div class="note" title="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 class="link" href="class-gdkscreen.html" title="gtk.gdk.Screen"><code class="classname">gtk.gdk.Screen</code></a>
objects are the <code class="literal">PyGTK</code> representation of a physical
screen. It is used throughout <code class="literal">PyGTK</code> to specify which
screen the top level windows are to be displayed on. It is also used to
query the screen specification and default settings such as the default
colormap (the <a class="link" href="class-gdkscreen.html#method-gdkscreen--get-default-colormap" title="gtk.gdk.Screen.get_default_colormap"><code class="methodname">get_default_colormap</code>()</a>
method), the screen width (the <a class="link" href="class-gdkscreen.html#method-gdkscreen--get-width" title="gtk.gdk.Screen.get_width"><code class="methodname">get_width</code>()</a>
method), etc.</p><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>a screen may consist of multiple monitors that are merged to
form a large screen area.</p></div></div><div class="refsect1" title="Methods"><a name="id3077238"></a><h2>Methods</h2><div class="refsect2" title="gtk.gdk.Screen.get_default_colormap"><a name="method-gdkscreen--get-default-colormap"></a><h3>gtk.gdk.Screen.get_default_colormap</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_default_colormap</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the default <a class="link" href="class-gdkcolormap.html" title="gtk.gdk.Colormap"><code class="classname">gtk.gdk.Colormap</code></a>.</td></tr></tbody></table><div class="note" title="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 <code class="methodname">get_default_colormap</code>() method
returns the default <a class="link" href="class-gdkcolormap.html" title="gtk.gdk.Colormap"><code class="classname">gtk.gdk.Colormap</code></a>
for the screen.</p></div><div class="refsect2" title="gtk.gdk.Screen.set_default_colormap"><a name="method-gdkscreen--set-default-colormap"></a><h3>gtk.gdk.Screen.set_default_colormap</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_default_colormap</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>colormap</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>colormap</code></strong> :</span></p></td><td>a <a class="link" href="class-gdkcolormap.html" title="gtk.gdk.Colormap"><code class="classname">gtk.gdk.Colormap</code></a></td></tr></tbody></table><div class="note" title="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 <code class="methodname">set_default_colormap</code>() method sets
the <a class="link" href="class-gdkcolormap.html" title="gtk.gdk.Colormap"><code class="classname">gtk.gdk.Colormap</code></a>
specified by <em class="parameter"><code>colormap</code></em> as the default colormap for the
screen.</p></div><div class="refsect2" title="gtk.gdk.Screen.get_system_colormap"><a name="method-gdkscreen--get-system-colormap"></a><h3>gtk.gdk.Screen.get_system_colormap</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_system_colormap</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the default colormap for the screen.
Since: 2.2</td></tr></tbody></table><div class="note" title="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 <code class="methodname">get_system_colormap</code>() method
returns the system's default colormap for the screen</p></div><div class="refsect2" title="gtk.gdk.Screen.get_system_visual"><a name="method-gdkscreen--get-system-visual"></a><h3>gtk.gdk.Screen.get_system_visual</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_system_visual</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the system <a class="link" href="class-gdkvisual.html" title="gtk.gdk.Visual"><code class="classname">gtk.gdk.Visual</code></a></td></tr></tbody></table><div class="note" title="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 <code class="methodname">get_system_visual</code>() method returns
the system's default <a class="link" href="class-gdkvisual.html" title="gtk.gdk.Visual"><code class="classname">gtk.gdk.Visual</code></a> for
the screen. This is the visual for the root window of the display.</p></div><div class="refsect2" title="gtk.gdk.Screen.get_rgb_colormap"><a name="method-gdkscreen--get-rgb-colormap"></a><h3>gtk.gdk.Screen.get_rgb_colormap</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_rgb_colormap</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>a <a class="link" href="class-gdkcolormap.html" title="gtk.gdk.Colormap"><code class="classname">gtk.gdk.Colormap</code></a></td></tr></tbody></table><div class="note" title="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 <code class="methodname">get_rgb_colormap</code>() method returns
the preferred colormap for rendering image data on the screen. Not a very
useful function; historically, <code class="literal">GDK</code> could only render RGB
image data to one colormap and visual, but in the current version it can
render to any colormap and visual. So there's no need to call this
function.</p></div><div class="refsect2" title="gtk.gdk.Screen.get_rgb_visual"><a name="method-gdkscreen--get-rgb-visual"></a><h3>gtk.gdk.Screen.get_rgb_visual</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_rgb_visual</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>a <a class="link" href="class-gdkvisual.html" title="gtk.gdk.Visual"><code class="classname">gtk.gdk.Visual</code></a></td></tr></tbody></table><div class="note" title="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 <code class="methodname">get_rgb_visual</code>() method returns a
"preferred visual" chosen for rendering <code class="literal">RGB</code> image data on
the screen.</p></div><div class="refsect2" title="gtk.gdk.Screen.get_root_window"><a name="method-gdkscreen--get-root-window"></a><h3>gtk.gdk.Screen.get_root_window</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_root_window</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the root <a class="link" href="class-gdkwindow.html" title="gtk.gdk.Window"><code class="classname">gtk.gdk.Window</code></a></td></tr></tbody></table><div class="note" title="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 <code class="methodname">get_root_window</code>() method returns
the root <a class="link" href="class-gdkwindow.html" title="gtk.gdk.Window"><code class="classname">gtk.gdk.Window</code></a> of
the screen.</p></div><div class="refsect2" title="gtk.gdk.Screen.get_display"><a name="method-gdkscreen--get-display"></a><h3>gtk.gdk.Screen.get_display</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_display</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the display that the screen belongs
to</td></tr></tbody></table><div class="note" title="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 <code class="methodname">get_display</code>() method returns the
<a class="link" href="class-gdkdisplay.html" title="gtk.gdk.Display"><code class="classname">gtk.gdk.Display</code></a>
that the screen belongs to.</p></div><div class="refsect2" title="gtk.gdk.Screen.get_number"><a name="method-gdkscreen--get-number"></a><h3>gtk.gdk.Screen.get_number</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_number</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the index</td></tr></tbody></table><div class="note" title="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 <code class="methodname">get_number</code>() method returns the
index of the screen among the screens in its display. (See the <a class="link" href="class-gdkscreen.html#method-gdkscreen--get-display" title="gtk.gdk.Screen.get_display"><code class="methodname">get_display()</code></a>
method)</p></div><div class="refsect2" title="gtk.gdk.Screen.get_width"><a name="method-gdkscreen--get-width"></a><h3>gtk.gdk.Screen.get_width</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_width</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the width of the screen in
pixels.</td></tr></tbody></table><div class="note" title="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 <code class="methodname">get_width</code>() method returns the
width of the screen in pixels</p></div><div class="refsect2" title="gtk.gdk.Screen.get_height"><a name="method-gdkscreen--get-height"></a><h3>gtk.gdk.Screen.get_height</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_height</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the height of the screen in
pixels.</td></tr></tbody></table><div class="note" title="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 <code class="methodname">get_height</code>() method returns the
height of the screen in pixels</p></div><div class="refsect2" title="gtk.gdk.Screen.get_width_mm"><a name="method-gdkscreen--get-width-mm"></a><h3>gtk.gdk.Screen.get_width_mm</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_width_mm</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the width of the screen in
millimeters.</td></tr></tbody></table><div class="note" title="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 <code class="methodname">get_width_mm</code>() method returns the
width of the screen in millimeters. Note that on some X servers this value
will not be correct.</p></div><div class="refsect2" title="gtk.gdk.Screen.get_height_mm"><a name="method-gdkscreen--get-height-mm"></a><h3>gtk.gdk.Screen.get_height_mm</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_height_mm</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the height of the screen in pixels.
Since: 2.2</td></tr></tbody></table><div class="note" title="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 <code class="methodname">get_height_mm</code>() method returns the
height of the screen in millimeters. Note that on some X servers this value
will not be correct.</p></div><div class="refsect2" title="gtk.gdk.Screen.list_visuals"><a name="method-gdkscreen--list-visuals"></a><h3>gtk.gdk.Screen.list_visuals</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">list_visuals</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>a list of <a class="link" href="class-gdkvisual.html" title="gtk.gdk.Visual"><code class="classname">gtk.gdk.Visual</code></a></td></tr></tbody></table><div class="note" title="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 <code class="methodname">list_visuals</code>() method returns a list
of the available visuals for the screen. A <a class="link" href="class-gdkvisual.html" title="gtk.gdk.Visual"><code class="classname">gtk.gdk.Visual</code></a>
describes a hardware image data format. For example, a visual might support
24-bit color, or 8-bit color, and might expect pixels to be in a certain
format.</p></div><div class="refsect2" title="gtk.gdk.Screen.get_toplevel_windows"><a name="method-gdkscreen--get-toplevel-windows"></a><h3>gtk.gdk.Screen.get_toplevel_windows</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_toplevel_windows</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>a list of the toplevel <a class="link" href="class-gdkwindow.html" title="gtk.gdk.Window"><code class="classname">gtk.gdk.Window</code></a> objects</td></tr></tbody></table><div class="note" title="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 <code class="methodname">get_toplevel_windows</code>() method
returns a list of all toplevel <a class="link" href="class-gdkwindow.html" title="gtk.gdk.Window"><code class="classname">gtk.gdk.Window</code></a>
objects known to <code class="literal">PyGTK</code> on the screen. A toplevel window
is a child of the root window (see the <a class="link" href="class-gdkwindow.html#function-gdk--get-default-root-window" title="gtk.gdk.get_default_root_window"><code class="function">gtk.gdk.get_default_root_window</code>()</a>
function).</p></div><div class="refsect2" title="gtk.gdk.Screen.make_display_name"><a name="method-gdkscreen--make-display-name"></a><h3>gtk.gdk.Screen.make_display_name</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">make_display_name</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>a generated nae</td></tr></tbody></table><div class="note" title="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 <code class="methodname">make_display_name</code>() method
determines the name to pass to <code class="function">gtk.gdk.Display()</code> to get
a <a class="link" href="class-gdkdisplay.html" title="gtk.gdk.Display"><code class="classname">gtk.gdk.Display</code></a>
with this screen as the default screen.</p></div><div class="refsect2" title="gtk.gdk.Screen.get_n_monitors"><a name="method-gdkscreen--get-n-monitors"></a><h3>gtk.gdk.Screen.get_n_monitors</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_n_monitors</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the number of monitors that the screen consists
of.</td></tr></tbody></table><div class="note" title="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 <code class="methodname">get_n_monitors</code>() method returns the
number of monitors that the screen consists of.</p></div><div class="refsect2" title="gtk.gdk.Screen.get_monitor_geometry"><a name="method-gdkscreen--get-monitor-geometry"></a><h3>gtk.gdk.Screen.get_monitor_geometry</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_monitor_geometry</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>monitor_num</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>monitor_num</code></strong> :</span></p></td><td>the monitor number.</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>a <a class="link" href="class-gdkrectangle.html" title="gtk.gdk.Rectangle"><code class="classname">gtk.gdk.Rectangle</code></a>
containing the monitor geometry</td></tr></tbody></table><div class="note" title="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 <code class="methodname">get_monitor_geometry</code>() method
returns a <a class="link" href="class-gdkrectangle.html" title="gtk.gdk.Rectangle"><code class="classname">gtk.gdk.Rectangle</code></a>
representing the size and position of the individual monitor within the the
entire screen area.</p><p>Note that the size of the entire screen area can be retrieved
via the <a class="link" href="class-gdkscreen.html#method-gdkscreen--get-width" title="gtk.gdk.Screen.get_width"><code class="methodname">get_width()</code></a>
and <a class="link" href="class-gdkscreen.html#method-gdkscreen--get-height" title="gtk.gdk.Screen.get_height"><code class="methodname">get_height()</code></a>. methods.</p></div><div class="refsect2" title="gtk.gdk.Screen.get_monitor_at_point"><a name="method-gdkscreen--get-monitor-at-point"></a><h3>gtk.gdk.Screen.get_monitor_at_point</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_monitor_at_point</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>x</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>y</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>x</code></strong> :</span></p></td><td>an x coordinate in the virtual
screen.</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>y</code></strong> :</span></p></td><td>a y coordinate in the virtual
screen.</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the number of the monitor that the point
(<em class="parameter"><code>x</code></em>,<em class="parameter"><code>y</code></em>) lies in, or a
monitor close to
(<em class="parameter"><code>x</code></em>,<em class="parameter"><code>y</code></em>) if the point
is not in any monitor.</td></tr></tbody></table><div class="note" title="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 <code class="methodname">get_monitor_at_point</code>() method
returns the number of the monitor in which the point
(<em class="parameter"><code>x</code></em>,<em class="parameter"><code>y</code></em>) is located or the
closest monitor if not in a monitor.</p></div><div class="refsect2" title="gtk.gdk.Screen.get_monitor_at_window"><a name="method-gdkscreen--get-monitor-at-window"></a><h3>gtk.gdk.Screen.get_monitor_at_window</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_monitor_at_window</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>window</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>window</code></strong> :</span></p></td><td>a <a class="link" href="class-gdkwindow.html" title="gtk.gdk.Window"><code class="classname">gtk.gdk.Window</code></a></td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the number of the monitor that most of <em class="parameter"><code>window</code></em> is located.
Since: 2.2</td></tr></tbody></table><div class="note" title="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 <code class="methodname">get_monitor_at_window</code>() method
returns the number of the monitor that most of the <a class="link" href="class-gdkwindow.html" title="gtk.gdk.Window"><code class="classname">gtk.gdk.Window</code></a>
specified by <em class="parameter"><code>window</code></em> is in. If
<em class="parameter"><code>window</code></em> does not intersect any monitors, the closest
monitor to the main bounding rectangle of <em class="parameter"><code>window</code></em> is
returned.</p></div><div class="refsect2" title="gtk.gdk.Screen.broadcast_client_message"><a name="method-gdkscreen--broadcast-client-message"></a><h3>gtk.gdk.Screen.broadcast_client_message</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">broadcast_client_message</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>event</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>event</code></strong> :</span></p></td><td>the <a class="link" href="class-gdkevent.html" title="gtk.gdk.Event"><code class="classname">gtk.gdk.Event</code></a>.</td></tr></tbody></table><div class="note" title="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 <code class="methodname">broadcast_client_message</code>() method
sends a message to all top level windows. On X11, sends an X ClientMessage
event to all toplevel windows on the screen.</p><p>Toplevel windows are determined by checking for the
<code class="literal">WM_STATE</code> property, as described in the Inter-Client
Communication Conventions Manual (ICCCM). If no windows are found with the
<code class="literal">WM_STATE</code> property set, the message is sent to all
children of the root window.</p><p>On Windows, broadcasts a message registered with the name
<code class="literal">GDK_WIN32_CLIENT_MESSAGE</code> to all top-level windows. The
amount of data is limited to one long, i.e. four bytes.</p></div><div class="refsect2" title="gtk.gdk.Screen.get_setting"><a name="method-gdkscreen--get-setting"></a><h3>gtk.gdk.Screen.get_setting</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_setting</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>name</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>name</code></strong> :</span></p></td><td>the name of the setting</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the value of
<em class="parameter"><code>setting</code></em></td></tr></tbody></table><div class="note" title="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 <code class="methodname">get_setting</code>() method returns the
value of the desktop-wide setting (specified by
<em class="parameter"><code>setting</code></em>) such as double-click time for the
screen.</p></div><div class="refsect2" title="gtk.gdk.Screen.get_rgba_colormap"><a name="method-gdkscreen--get-rgba-colormap"></a><h3>gtk.gdk.Screen.get_rgba_colormap</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_rgba_colormap</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>a <a class="link" href="class-gdkcolormap.html" title="gtk.gdk.Colormap"><code class="classname">gtk.gdk.Colormap</code></a>
for use with windows with an alpha channel or <code class="literal">None</code>
if the capability is not available.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.10 and above.</p></div><p>The <code class="methodname">get_rgba_colormap</code>() method returns
a colormap to use for creating windows or pixmaps with an alpha
channel. The windowing system on which PyGTK is running may not
support this capability, in which case <code class="literal">None</code> will be
returned. Even if a non-<code class="literal">None</code> value is returned,
it's possible that the window's alpha channel won't be honored when
displaying the window on the screen: in particular, for X an
appropriate windowing manager and compositing manager must be running
to provide appropriate display.</p></div><div class="refsect2" title="gtk.gdk.Screen.get_rgba_visual"><a name="method-gdkscreen--get-rgba-visual"></a><h3>gtk.gdk.Screen.get_rgba_visual</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_rgba_visual</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>a <a class="link" href="class-gdkvisual.html" title="gtk.gdk.Visual"><code class="classname">gtk.gdk.Visual</code></a>
to use for windows with an alpha channel or <code class="literal">None</code>
if the capability is not available.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.10 and above.</p></div><p>The <code class="methodname">get_rgba_visual</code>() method returns a
visual to use for creating windows or pixmaps with an alpha
channel. See the <a class="link" href="class-gdkscreen.html#method-gdkscreen--get-rgba-colormap" title="gtk.gdk.Screen.get_rgba_colormap"><code class="methodname">get_rgba_colormap</code>()</a>
method for caveats.</p></div><div class="refsect2" title="gtk.gdk.Screen.get_monitor_height_mm"><a name="method-gdkscreen--get-monitor-height-mm"></a><h3>gtk.gdk.Screen.get_monitor_height_mm</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_monitor_height_mm</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>monitor_num</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>monitor_num</code></strong> :</span></p></td><td>Number of the monitor.</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>The height of the monitor, or -1 if not available.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.14 and above.</p></div><p>
The <code class="methodname">get_monitor_height_mm</code>() method gets the height
in millimeters of the specified monitor.
</p></div><div class="refsect2" title="gtk.gdk.Screen.get_monitor_width_mm"><a name="method-gdkscreen--get-monitor-width-mm"></a><h3>gtk.gdk.Screen.get_monitor_width_mm</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_monitor_width_mm</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>monitor_num</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>monitor_num</code></strong> :</span></p></td><td>Number of the monitor.</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>The width of the monitor, or -1 if not available.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.14 and above.</p></div><p>
The <code class="methodname">get_monitor_width_mm</code>() method gets the width
in millimeters of the specified monitor.
</p></div><div class="refsect2" title="gtk.gdk.Screen.get_monitor_plug_name"><a name="method-gdkscreen--get-monitor-plug-name"></a><h3>gtk.gdk.Screen.get_monitor_plug_name</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_monitor_plug_name</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>monitor_num</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>monitor_num</code></strong> :</span></p></td><td>Number of the monitor.</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>A newly-allocated string containing the name of the monitor,
or <code class="literal">None</code> if the name cannot be determined.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.14 and above.</p></div><p>
The <code class="methodname">get_monitor_plug_name</code>() method returns the output
name of the specified monitor. Usually something like VGA, DVI, or TV, not the
actual product name of the display device.
</p></div></div><div class="refsect1" title="Functions"><a name="id3494633"></a><h2>Functions</h2><div class="refsect2" title="gtk.gdk.screen_width"><a name="function-gdk--screen-width"></a><h3>gtk.gdk.screen_width</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">gtk.gdk.screen_width</span>()</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>
the width of the default screen in pixels.</td></tr></tbody></table><p>The <code class="function">gtk.gdk.screen_width</code>() function
returns the width of the default screen in pixels.</p></div><div class="refsect2" title="gtk.gdk.screen_height"><a name="function-gdk--screen-height"></a><h3>gtk.gdk.screen_height</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">gtk.gdk.screen_height</span>()</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>
the height of the default screen in pixels.</td></tr></tbody></table><p>The <code class="function">gtk.gdk.screen_height</code>() function
returns the height of the default screen in pixels.</p></div><div class="refsect2" title="gtk.gdk.screen_width_mm"><a name="function-gdk--screen-width-mm"></a><h3>gtk.gdk.screen_width_mm</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">gtk.gdk.screen_width_mm</span>()</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>
the width of the default screen in millimeters, though it is not
always correct.</td></tr></tbody></table><p>The <code class="function">gtk.gdk.screen_width_mm</code>() function
returns the width of the default screen in millimeters. Note that on many X
servers this value will not be correct.</p></div><div class="refsect2" title="gtk.gdk.screen_height_mm"><a name="function-gdk--screen-height-mm"></a><h3>gtk.gdk.screen_height_mm</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">gtk.gdk.screen_height_mm</span>()</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>
the height of the default screen in millimeters, though it is not
always correct.</td></tr></tbody></table><p>The <code class="function">gtk.gdk.screen_height_mm</code>() function
returns the height of the default screen in millimeters. Note that on many X
servers this value will not be correct.</p></div><div class="refsect2" title="gtk.gdk.screen_get_default"><a name="function-gdk--screen-get-default"></a><h3>gtk.gdk.screen_get_default</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">gtk.gdk.screen_get_default</span>()</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>a <a class="link" href="class-gdkscreen.html" title="gtk.gdk.Screen"><code class="classname">gtk.gdk.Screen</code></a>,
or <code class="literal">None</code> if there is no default
display.</td></tr></tbody></table><div class="note" title="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 <code class="function">gtk.gdk.screen_get_default</code>() function
returns the default <a class="link" href="class-gdkscreen.html" title="gtk.gdk.Screen"><code class="classname">gtk.gdk.Screen</code></a> for
the default <a class="link" href="class-gdkdisplay.html" title="gtk.gdk.Display"><code class="classname">gtk.gdk.Display</code></a>. (See
the <a class="link" href="class-gdkdisplay.html#function-gdk--display-get-default" title="gtk.gdk.display_get_default"><code class="function">gtk.gdk.display_get_default</code>()</a>
function).</p></div></div><div class="refsect1" title="Signals"><a name="id3494946"></a><h2>Signals</h2><div class="refsect2" title='The "size-changed" gtk.gdk.Screen Signal'><a name="signal-gdkscreen--size-changed"></a><h3>The "size-changed" gtk.gdk.Screen Signal</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>screen</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>screen</code></em> :</span></p></td><td>the screen that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
any)</td></tr></tbody></table><p>The "size-changed" signal is emitted when the pixel width or
height of a screen changes.</p></div><div class="refsect2" title='The "monitor-changed" gtk.gdk.Screen Signal'><a name="signal-gdkscreen--monitor-changed"></a><h3>The "monitor-changed" gtk.gdk.Screen Signal</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>screen</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>screen</code></em> :</span></p></td><td>the screen that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
any)</td></tr></tbody></table><p>
The "monitor-changed" signal is emitted when the number, size or position
of the monitors attached to the screen change.
</p><p>
Only for X for now. Future implementations for Win32 and OS X may be a possibility.
</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-gdkregion.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-gdkvisual.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">gtk.gdk.Region </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> gtk.gdk.Visual</td></tr></table></div></body></html>
|