名称

XOpenDisplay, XCloseDisplay − X サーバとの接続または切離し

形式

Display ∗XOpenDisplay(display_name)
      char ∗display_name; XCloseDisplay(display)
      Display ∗display;

引数

displayX サーバへのコネクションを指定します。

display_name
ハードウェア表示名を指定し、それにより、使用するディスプレイおよび 通信領域を決定します。 POSIX 準拠のシステムでは、display_name が NULL の場合、 DISPLAY 環境変数の値にデフォルト設定されます。

解説

XOpenDisplay 関数は、X サーバへのコネクションとして役立ち、X サーバに関する すべての情報を含む Display 構造体を返します。 XOpenDisplay は、TCP、DECnet 通信プロトコル、あるいはローカルなプロセス間通信プロトコル により、アプリケーションを X サーバへ接続します。 ホスト名が、ホストマシンの名前で、シングルコロン (:) がホスト名と表示番号を区切る場合は、 XOpenDisplay は、TCP ストリームを用いて接続します。 ホスト名が unix で 、シングルコロン (:) がそのホスト名と表示番号を区切る場合、 XOpenDisplay は、UNIX ドメインの IPC ストリームを用いて接続します。 ホスト名が、指定されていない場合は、 Xlib は、一番速い転送であると信じるものは何でも使用します。 ホスト名が、ホストマシンの名前で、ダブルコロン (::) が、ホスト名と表示番号を区切る場合は、 XOpenDisplay は、DECnet を使用して接続します。 X サーバ 1 つで、これらの転送メカニズムの一部またはすべてを同時に サポートすることができます。 特別な Xlib インプリメンテーションは、これらの転送メカニズム の多くをサポートすることができます。 成功した場合、 XOpenDisplay は <X11/Xlib.h> に定義されている Display 構造体を指すポインタを返します。 XOpenDisplay が失敗した場合は、NULL を返します。 XOpenDisplay への呼び出しが成功した後は、 そのディスプレイのすべての表示領域を、クライアントは使用することができます。 display_name 引数で指定されたスクリーン番号は、 DefaultScreen マクロ (または、 XDefaultScreen 関数) により返されます。 情報マクロまたは関数を使用することによってだけ、 Display および Screen 構造体の要素にアクセスすることができます。 Display 構造体から情報を得るためのマクロおよび関数の使用についての情報は、 2.2.1 節を参照して下さい。 XCloseDisplay 関数は、 Display 構造体で指定された表示についての X サーバへのコネクションをクローズし、 リソースの close_down モードが変更されない限り ( XSetCloseDownMode 参照) 、すべてのウィンドウ、リソース ID (Window、 Font、 Pixmap、 Colormap、 Cursor および GContext)、 または、クライアントらがこのディスプレイ上に作成した 他のリソースを破壊します。 それ故、これらのウィンドウ、リソース ID 、および他のリソースを、 再度参照することは決して許されません。 さもないと、エラーが生じます。 終了する前に、 XCloseDisplay が、最終の XSync 操作を行うときに、ペンディングされているエラーが通知されるように、 明示的に、 XCloseDisplay を呼び出さなければなりません。 XCloseDisplay は、 BadGC エラーを生じることがあります。

関連事項

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

NEWS-OSRelease 4.2.1R