GeezerVison is showing github.com — python-xlib.github.io/python-xlib_3.html at master · python-xlib/python-xlib.github.io

Expand file tree

python-xlib_3.html

Copy path

More file actions

Latest commit

History

121 lines (110 loc) · 5.13 KB

python-xlib_3.html

Copy path

File metadata and controls

121 lines (110 loc) · 5.13 KB

Raw

Copy raw file

Download raw file

Open symbols panel

Edit and raw actions

100

101

102

103

104

105

106

107

108

109

110

111

112

113

114

115

116

117

118

119

120

121

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">

<html>

<!-- Created on September 16, 2020 by texi2html 5.0

texi2html was written by:

Lionel Cons <[email protected]> (original author)

Karl Berry <[email protected]>

Olaf Bachmann <[email protected]>

and many others.

Maintained by: Many creative people.

Send bugs and suggestions to <[email protected]>

-->

<head>

<title>The Python X Library: 3 Connect to a Display</title>

<!--

a.summary-letter {text-decoration: none}

blockquote.smallquotation {font-size: smaller}

div.display {margin-left: 3.2em}

div.example {margin-left: 3.2em}

div.lisp {margin-left: 3.2em}

div.smalldisplay {margin-left: 3.2em}

div.smallexample {margin-left: 3.2em}

div.smalllisp {margin-left: 3.2em}

pre.display {font-family: serif}

pre.format {font-family: serif}

pre.menu-comment {font-family: serif}

pre.menu-preformatted {font-family: serif}

pre.smalldisplay {font-family: serif; font-size: smaller}

pre.smallexample {font-size: smaller}

pre.smallformat {font-family: serif; font-size: smaller}

pre.smalllisp {font-size: smaller}

span.nocodebreak {white-space:pre}

span.nolinebreak {white-space:pre}

span.roman {font-family:serif; font-weight:normal}

span.sansserif {font-family:sans-serif; font-weight:normal}

ul.no-bullet {list-style: none}

-->

</style>

</head>

<td valign="middle" align="left">[<a href="python-xlib_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>

<td valign="middle" align="left">[Index]</td>

</tr></table>

<hr>

<h1 class="chapter">3 Connect to a Display</h1>

<p>To be able to perform any X operations, you must first establish a

connection to the display. This is done by instantiating a

<code>display.Display</code> object:

</p>

<dl>

<dt><a name="index-Display"></a>Class: <strong>Display</strong><em> ( [ displayname ] )</em></dt>

<dd>

<p>Create a connection to the display called <var>displayname</var>. If

<var>displayname</var> is None or not provided, connect to the default

display.

</p>

<p>If the connection fails for some reason, one of the errors from the

following error class tree is raised:

</p>

<pre class="display">Exception

\_error.DisplayError

\_error.DisplayNameError

\_error.DisplayConnectionError

</pre></div>

<p><code>error.DisplayNameError</code> is raised if <var>displayname</var>, or the

default display name, is malformed. <code>error.DisplayConnectionError</code>

is raised if the connection to the X server fails. This might be caused

by the network connection to the display failing, or if the client

isn’t authorized to connect to the display.

</p>

</dd></dl>

<p>The syntax of a display name and how the library finds the default

display name depends on the operating system where the client runs.

</p>

<tr><td align="left" valign="top"><a href="python-xlib_4.html#Unix-Display-Names">3.1 Unix Display Names</a></td><td>  </td><td align="left" valign="top"> Most Unix-style operating systems.

</td></tr>

<tr><td align="left" valign="top"><a href="python-xlib_5.html#OpenVMS-Display-Names">3.2 OpenVMS Display Names</a></td><td>  </td><td align="left" valign="top"> Digital^H^H^H^H^H^H^HCompaq OpenVMS.

</td></tr>

</table>

<hr>

<p>

This document was generated on <i>September 16, 2020</i> using <a href="http://www.nongnu.org/texi2html/"><i>texi2html 5.0</i></a>.

</font>

<br>

</p>

</body>

</html>