.\" $Xorg: XtDisplayI.man,v 1.3 2000/08/17 19:42:00 cpqbld Exp $
.\"
.\" Copyright (c) 1993, 1994  X Consortium
.\" 
.\" Permission is hereby granted, free of charge, to any person obtaining a
.\" copy of this software and associated documentation files (the "Software"), 
.\" to deal in the Software without restriction, including without limitation 
.\" the rights to use, copy, modify, merge, publish, distribute, sublicense, 
.\" and/or sell copies of the Software, and to permit persons to whom the 
.\" Software furnished to do so, subject to the following conditions:
.\" 
.\" The above copyright notice and this permission notice shall be included in
.\" all copies or substantial portions of the Software.
.\" 
.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
.\" IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
.\" FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL 
.\" THE X CONSORTIUM BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, 
.\" WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF 
.\" OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE 
.\" SOFTWARE.
.\" 
.\" Except as contained in this notice, the name of the X Consortium shall not 
.\" be used in advertising or otherwise to promote the sale, use or other 
.\" dealing in this Software without prior written authorization from the 
.\" X Consortium.
.\"
.\" Copyright (c) 1998, 2001 The X Japanese Documentation Project.
.\"
.\" Permission is hereby granted, free of charge, to any person obtaining a
.\" copy of this software and associated documentation files (the
.\" "Software"), to deal in the Software without restriction, including
.\" without limitation the rights to use, copy, modify, merge, publish, dis-
.\" tribute, sublicense, and/or sell copies of the Software, and to permit
.\" persons to whom the Software is furnished to do so, subject to the fol-
.\" lowing conditions:
.\"
.\" The above copyright notice and this permission notice shall be included
.\" in all copies or substantial portions of the Software.
.\"
.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
.\" OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABIL-
.\" ITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT
.\" SHALL  THE X JAPANESE DOCUMENTATION PROJECT  BE  LIABLE  FOR  ANY CLAIM,
.\" DAMAGES OR OTHER LIABILITY,  WHETHER IN AN ACTION OF CONTRACT,  TORT OR
.\" OTHERWISE,  ARISING FROM,  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR
.\" THE USE OR OTHER DEALINGS IN THE SOFTWARE.
.\"
.\" Except as contained in this notice, the name of The X Japanese
.\" Documentation Project shall not be used in advertising or otherwise to
.\" promote the sale, use or other dealings in this Software without prior
.\" written authorization from The X Japanese Documentation Project.
.\"
.\" Translated Thu Sep 17 17:27:52 JST 1998
.\"         by Ito Hiromi <hiromi@marimo.or.jp>
.\" Updated Thu Oct 11 01:06:39 JST 2001 for XFree86 4.1.0
.\"         by FUJIWARA Teruyoshi <fujiwara@linux.or.jp>
.\"
.\" WORD:	synchronize resource	同期リソース
.\" WORD:       intrinsics              イントリンシクス
.\"
.\" $XFree86: xc/doc/man/Xt/XtDisplayI.man,v 1.3 2001/02/09 03:47:50 tsi Exp $
.\"
.\" .ds tk X Toolkit
.ds tk X ツールキット
.\" .ds xT X Toolkit Intrinsics \- C Language Interface
.ds xT X ツールキット イントリンシクス \- C 言語インターフェイス
.\" .ds xI Intrinsics
.ds xI イントリンシクス
.\" .ds xW X Toolkit Athena Widgets \- C Language Interface
.ds xW X ツールキット Athena ウィジェット \- C 言語インターフェイス
.\" .ds xL Xlib \- C Language X Interface
.ds xL Xlib \- C 言語 X インターフェイス
.\" .ds xC Inter-Client Communication Conventions Manual
.ds xC クライアント間通信規約マニュアル
.ds Rn 3
.ds Vn 2.2
.hw XtDisplay-Initialize XtOpen-Display XtClose-Display XtDatabase XtScreen-Database wid-get
.na
.de Ds
.nf
.\\$1D \\$2 \\$1
.ft 1
.ps \\n(PS
.\".if \\n(VS>=40 .vs \\n(VSu
.\".if \\n(VS<=39 .vs \\n(VSp
..
.de De
.ce 0
.if \\n(BD .DF
.nr BD 0
.in \\n(OIu
.if \\n(TM .ls 2
.sp \\n(DDu
.fi
..
.de FD
.LP
.KS
.TA .5i 3i
.ta .5i 3i
.nf
..
.de FN
.fi
.KE
.LP
..
.de IN		\" send an index entry to the stderr
..
.de C{
.KS
.nf
.D
.\"
.\"	choose appropriate monospace font
.\"	the imagen conditional, 480,
.\"	may be changed to L if LB is too
.\"	heavy for your eyes...
.\"
.ie "\\*(.T"480" .ft L
.el .ie "\\*(.T"300" .ft L
.el .ie "\\*(.T"202" .ft PO
.el .ie "\\*(.T"aps" .ft CW
.el .ft R
.ps \\n(PS
.ie \\n(VS>40 .vs \\n(VSu
.el .vs \\n(VSp
..
.de C}
.DE
.R
..
.de Pn
.ie t \\$1\fB\^\\$2\^\fR\\$3
.el \\$1\fI\^\\$2\^\fP\\$3
..
.de ZN
.ie t \fB\^\\$1\^\fR\\$2
.el \fI\^\\$1\^\fP\\$2
..
.de NT
.ne 7
.ds NO Note
.if \\n(.$>$1 .if !'\\$2'C' .ds NO \\$2
.if \\n(.$ .if !'\\$1'C' .ds NO \\$1
.ie n .sp
.el .sp 10p
.TB
.ce
\\*(NO
.ie n .sp
.el .sp 5p
.if '\\$1'C' .ce 99
.if '\\$2'C' .ce 99
.in +5n
.ll -5n
.R
..
.		\" Note End -- doug kraft 3/85
.de NE
.ce 0
.in -5n
.ll +5n
.ie n .sp
.el .sp 10p
..
.ny0
.TH XtDisplayInitialize 3Xt "Release 6.5" "X Version 11" "XT FUNCTIONS"
.SH 名前
XtDisplayInitialize, XtOpenDisplay, XtDatabase, XtScreenDatabase, XtCloseDisplay \- ディスプレイを初期化・オープン・クローズする
.SH 書式
void XtDisplayInitialize(\fIapp_context\fP, \fIdisplay\fP,
\fIapplication_name\fP, \fIapplication_class\fP,
.br
                       \fIoptions\fP, \fInum_options\fP, \fIargc\fP, \fIargv\fP)
.br
      XtAppContext \fIapp_context\fP;
.br
      Display *\fIdisplay\fP;
.br
      String \fIapplication_name\fP;
.br
      String \fIapplication_class\fP;
.br
      XrmOptionDescRec *\fIoptions\fP;
.br
      Cardinal \fInum_options\fP;
.br
      int *\fIargc\fP;
.br
      String *\fIargv\fP;
.LP
Display *XtOpenDisplay(\fIapp_context\fP, \fIdisplay_string\fP,
\fIapplication_name\fP, \fIapplication_class\fP, 
.br
                       \fIoptions\fP, \fInum_options\fP, \fIargc\fP, \fIargv\fP)
.br
       XtAppContext \fIapp_context\fP;
.br
       String \fIdisplay_string\fP;
.br
       String \fIapplication_name\fP;
.br
       String \fIapplication_class\fP;
.br
       XrmOptionDescRec *\fIoptions\fP;
.br
       Cardinal \fInum_options\fP;
.br
       int *\fIargc\fP;
.br
       String *\fIargv\fP;
.LP
void XtCloseDisplay(\fIdisplay\fP)
.br
      Display *\fIdisplay\fP;
.LP
XrmDatabase XtDatabase(\fIdisplay\fP)
.br
      Display *\fIdisplay\fP;
.LP
XrmDatabase XtScreenDatabase(\fIscreen\fP)
.br
      Screen* \fIscreen\fP;
.SH 引き数
.IP \fIargc\fP 1i
コマンド行パラメータの個数へのポインタを指定する。
.IP \fIargv\fP 1i
コマンド行パラメータを指定する。
.IP \fIapp_context\fP 1i
アプリケーションコンテクストを指定する。
.IP \fIapplication_class\fP 1i
このアプリケーションのクラス名を指定する。通常はこのアプリケーションの
全インスタンスの総称的名称である。
.IP \fIapplication_name\fP 1i
アプリケーションのインスタンス名を指定する。
.IP \fIdisplay\fP 1i
ディスプレイを指定する。 1 つのディスプレイは 1 つのアプリケーションコ
ンテクストにだけ存在することができる点に注意すること。
.IP \fInum_options\fP 1i
options リストのエントリの個数を指定する。
.IP \fIoptions\fP 1i
アプリケーション固有のリソースに対する、コマンド行の解析方法を指定する。
options 引き数は
.ZN XrmParseCommand 
にパラメタとして渡される。
詳細は
\*(xL
を参照。
.IP \fIscreen\fP 1i
返り値であるリソースデータベースに所属するスクリーンを指定する。
.SH 説明
.ZN XtDisplayInitialize
関数はリソースデータベースをビルドし、コマンド行を解析するために
.ZN XrmParseCommand
関数を呼び、さらに他のディスプレイ毎に初期化を実施する。
.ZN XrmParseCommand 
が呼ばれた後、
argc と argv は標準のオプションテーブルにないパラメータや、 options 引
数によって指定されたテーブルにもないパラメータだけを含むことになる。
もし変更後の argc が 0 であった時は、ほとんどのアプリケーションは、単
に変更された argv を、指定可能なオプションのリストとともに表示するだけ
となる。
一般的にUNIXベースのシステムにおいて、アプリケーション名は argv[0] の
最後の構成要素になる。
指定されたアプリケーションの同期リソースが
.ZN True
ならば、
.ZN XtDisplayInitialize
はこのディスプレイの接続において Xlib を同期モードにするために
.ZN XSynchronize
関数を呼ぶ。
また、reverseVideo リソースが
.ZN True 
であれば、このディスプレイ上で生成されたウィジェットに対して、
\*(xIは
.ZN XtDefaultForeground
と
.ZN XtDefaultBackground
を交換する。
(Section 9.6.1 を参照)
.LP
.ZN XtOpenDisplay
関数は指定されたディスプレイ名を使用して
.ZN XOpenDisplay 
を呼ぶ。
display_string が NULL の場合、
.ZN XtOpenDisplay
は argv に指定された \-display オプションの現在の値を使用する。ただしこ
の argv にディスプレイが指定されていない場合は、ユーザのデフォルトのデ
ィスプレイ(UNIX ベースのシステムにおける環境変数 DISPLAY の値)を使用する。
.LP
これが成功した場合、
.ZN XtOpenDisplay
関数は
.ZN XtDisplayInitialize
を呼び、オープンしたディスプレイとアプリケーション名として argv に指定
された \-name オプションの値を渡す。
ただしこの \-name オプションが指定されていない場合は、
.ZN XtOpenDisplay 
に渡されたアプリケーション名を使用する。
さらにこのアプリケーション名が NULL の場合は、argv[0] の最後の構成要素
を使用する。
.ZN XtOpenDisplay
は正常に終了すれば新しくオープンしたディスプレイを返し、逆に失敗すれば
NULL を返す。
.LP
アプリケーションプログラマに便宜をはかるために
.ZN XtOpenDisplay
は提供されている。
.LP
.ZN XtCloseDisplay
関数はクローズが安全に行えるようになりしだい、指定されたディスプレイを
クローズする。
もしイベント配送 (例えばコールバック手続き) 中に呼び出された場
合、配送が完了するまで
.ZN XtCloseDisplay 
はディスプレイをクローズしない。
ディスプレイをクローズした後もアプリケーションを実行し続ける場合のみ、
.ZN XtCloseDisplay 
を呼ぶことができることに注意すること。そうでなければ
.ZN XtDestroyApplicationContext 
を呼ぶか、ただ終了すればよい。
.LP
.ZN XtDatabase 
関数は指定したディスプレイに関して、
.ZN XtDisplayInitialize 
によって生成された、完全にマージされたリソースデータベースを返す。
このディスプレイが
.ZN XtDisplayInitialize 
によって初期化されていない場合、その返り値は未定義である。
.LP
.ZN XtScreenDatabase 
関数は指定されたスクリーンに対応する、完全にマージされたリソースデータ
ベースを返す。
.ZN XtDisplayInitialize 
によって初期化された
.ZN Display 
に
\fIscreen\fP が所属していない場合、その返り値は未定義である。
.SH 関連項目
XtAppCreateShell(3Xt),
XtCreateApplicationContext(3Xt)
.br
\*(xT
.br
\*(xL