NOM¶

XOpenDisplay, XCloseDisplay - ouvre ou ferme une connexion avec un serveur X

SYNTAXE¶

Display *XOpenDisplay(display_name)
char *display_name;

XCloseDisplay(display)
Display *display;

ARGUMENTS¶

display

Spécifie la connexion au serveur X.

display_name

Spécifie le nom physique du périphérique d'affichage, ce qui détermine le périphérique d'affichage et le domaine de communication à utiliser. Sur un système POSIX, si le display_name est NULL, la valeur de la variable d'environnement DISPLAY est prise par défaut.

DESCRIPTION¶

La fonction XOpenDisplay renvoie une structure Display qui sert de connexion au serveur X et qui contient toutes les informations sur le serveur X. XOpenDisplay connecte votre application au serveur X via les protocoles réseau TCP ou DECnet, ou via un protocole de communication inter-processus. Si le nom d'hôte est le nom d'une machine et qu'un seul « deux-points » (:) sépare le nom d'hôte et le numéro du périphérique d'affichage, XOpenDisplay ouvre une connexion en utilisant TCP. Si le nom d'hôte n'est pas spécifié, Xlib utilise ce qu'elle estime être le mode de transport le plus rapide. Si le nom d'hôte est le nom d'une machine et qu'un double « deux-points » (::) sépare le nom d'hôte et le numéro du périphérique d'affichage, XOpenDisplay ouvre une connexion en utilisant DECnet. Un seul serveur X peut supporter l'un ou l'ensemble de ces mécanismes de transport simultanément. Une implémentation particulière de Xlib peut supporter beaucoup plus de mécanismes de transport.

En cas de succès, XOpenDisplay renvoie un pointeur sur une structure Display définie dans <X11/Xlib.h>. Si XOpenDisplay échoue, elle retourne NULL. Après un appel réussi à XOpenDisplay, tous les écrans du périphérique d'affichage peuvent être utilisés par le client. Le numéro d'écran spécifié dans l'argument display_name est retourné par la macro DefaultScreen (ou la fonction XDefaultScreen). Vous ne devez accéder aux membres des structures Display et Screen qu'à travers les macros ou les fonctions adéquates. Pour plus d'information sur l'utilisation des macros et des fonctions d'accès aux membres de la structure Display, voir la section 2.2.1.

La fonction XCloseDisplay ferme la connexion au serveur X pour le périphérique d'affichage spécifié par la structure Display et détruit toutes les fenêtres, les IDs de ressources (Window, Font, Pixmap, Colormap, Cursor, et GContext), et les autres ressources que le client a créés sur le périphérique d'affichage, à moins que le mode de fermeture de la ressource ait été modifié (voir XSetCloseDownMode). Toutefois, ces fenêtres, IDs de ressources, et autres ressources ne doivent pas être référencés à nouveau ou une erreur sera générée. Avant de quitter, vous devriez appeler XCloseDisplay explicitement de telle sorte que toutes les erreurs en attente soient rapportées lorsque XCloseDisplay effectue un appel final à XSync.

XCloseDisplay peut générer une erreur BadGC.

VOIR AUSSI¶

AllPlanes(3X11), XFlush(3X11), XSetCloseDownMode(3X11)
Xlib - C Language X Interface

TRADUCTION¶

Bertrand Duret, 2001.