| Server IP : 93.86.61.54 / Your IP : 216.73.216.60 Web Server : Apache/2.4.62 (Ubuntu) System : Linux rasin.ddns.net 6.8.0-124-generic #124~22.04.1-Ubuntu SMP PREEMPT_DYNAMIC Tue May 26 21:05:19 UTC x86_64 User : www-data ( 33) PHP Version : 8.4.22 Disable Function : NONE MySQL : OFF | cURL : ON | WGET : ON | Perl : ON | Python : OFF | Sudo : ON | Pkexec : ON Directory : /usr/share/doc/python3-xlib/html/ |
Upload File : |
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Connect to a Display (The Python X Library)</title>
<meta name="description" content="Connect to a Display (The Python X Library)">
<meta name="keywords" content="Connect to a Display (The Python X Library)">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
<link href="index.html" rel="start" title="Top">
<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="index.html" rel="up" title="Top">
<link href="Unix-Display-Names.html" rel="next" title="Unix Display Names">
<link href="Package-Layout.html" rel="prev" title="Package Layout">
<style type="text/css">
<!--
a.summary-letter {text-decoration: none}
blockquote.indentedblock {margin-right: 0em}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
div.lisp {margin-left: 3.2em}
kbd {font-style: oblique}
pre.display {font-family: inherit}
pre.format {font-family: inherit}
pre.menu-comment {font-family: serif}
pre.menu-preformatted {font-family: serif}
span.nolinebreak {white-space: nowrap}
span.roman {font-family: initial; font-weight: normal}
span.sansserif {font-family: sans-serif; font-weight: normal}
ul.no-bullet {list-style: none}
-->
</style>
</head>
<body lang="en">
<span id="Connect-to-a-Display"></span><div class="header">
<p>
Next: <a href="Error-Handling.html" accesskey="n" rel="next">Error Handling</a>, Previous: <a href="Package-Layout.html" accesskey="p" rel="prev">Package Layout</a>, Up: <a href="index.html" accesskey="u" rel="up">Top</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p>
</div>
<hr>
<span id="Connect-to-a-Display-1"></span><h2 class="chapter">3 Connect to a Display</h2>
<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 id="index-Display">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>
<div class="display">
<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>
<table class="menu" border="0" cellspacing="0">
<tr><td align="left" valign="top">• <a href="Unix-Display-Names.html" accesskey="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="OpenVMS-Display-Names.html" accesskey="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>
</body>
</html>