.ds xT X Toolkit Intrinsics - C Language Interface .ds xW Athena X Widgets - C Language X Toolkit Interface .ds xL Xlib - C Language X Interface .ds xC Inter-Client Communication Conventions Manual .na .de Ds .nf .ft 1 .. .de De .ce 0 .if
(BD .DF .nr BD 0 .in
(OIu .if
(TM .ls 2
(DDu .fi .. .de FD
 
  .KS .TA .5i 3i .ta .5i 3i .nf .. .de FN .fi .KE

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 1i

Spécifie la connexion au serveur X.

display_name 1i

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. .IN "Environnement" "DISPLAY"

Description

La fonction .ZN XOpenDisplay renvoie une structure .ZN Display qui sert de connexion au serveur X et qui contient toutes les informations sur le serveur X. .ZN XOpenDisplay connecte votre application au serveur X via les protocoles réseau TCP ou DECnet, ou via un protocole de communication inter-processus. .IN "Protocole" "TCP" .IN "Protocole" "DECnet" 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, .ZN 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, .ZN 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.
 
  .IN "Display" En cas de succès, .ZN XOpenDisplay renvoie un pointeur sur une structure .ZN Display définie dans .hN X11/Xlib.h . Si .ZN XOpenDisplay échoue, elle retourne NULL. Après un appel réussi à .ZN 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 .ZN DefaultScreen (ou la fonction .ZN XDefaultScreen ). Vous ne devez accéder aux membres des structures .ZN Display et .ZN 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 .ZN Display , voir la section 2.2.1.
 
  La fonction .ZN XCloseDisplay ferme la connexion au serveur X pour le périphérique d'affichage spécifié par la structure .ZN Display et détruit toutes les fenêtres, les IDs de ressources .Pn ( Window , .ZN Font , .ZN Pixmap , .ZN Colormap , .ZN Cursor , et .ZN 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 .ZN 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 .ZN XCloseDisplay explicitement de telle sorte que toutes les erreurs en attente soient rapportées lorsque .ZN XCloseDisplay effectue un appel final à .ZN XSync . .IN "IDs de Ressource" .IN "XCloseDisplay"
 
  .ZN XCloseDisplay peut générer une erreur .ZN BadGC .

Voir aussi

AllPlanes(3X11), XFlush(3X11), XSetCloseDownMode(3X11) *(xL

Traduction

Bertrand Duret, 2001.