名称

XMapWinow, XMapRaised, XMapSubwindows − ウィンドウをマップする

形式

XMapWindow(display, w)
      Display ∗display;
      Window w; XMapRaised(display, w)
      Display ∗display;
      Window w; XMapSubwindows(display, w)
      Display ∗display;
      Window w;

引数

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

wウィンドウを指定します。

解説

XMapWindow 関数は、 マップリクエストをもっているウィンドウおよびそのすべてのサブウィンドウ をマップします。 マップされていない先祖をもつウィンドウをマップしても、 ウィンドウは表示されないが、その先祖がマップされた時には、 そのウィンドウは表示されます。 このようなウィンドウを、表示不可能なウィンドウと呼びます。 すべての先祖がマップされた時、 ウィンドウは表示可能となり、 別のウインドウにより隠されない限りスクリーン上に見ることができます。 ウィンドウがすでにマップされている場合は、 XMapWindow 関数は何も行いません。 ウィンドウの override-redirect が False の場合、および他のクライアントが親ウィンドウ上の SubstructureRedirectMask を選択している場合は、 X サーバが、 MapRequest イベントを発生し、 XMapWindow 関数はウィンドウをマップしません。 そうでない場合は、ウインドウはマップされ、 X サーバは、 MapNotify イベントを発生します。 ウインドウがビューアブルとなり、そのウィンドウの以前の内容が 何もストアされていない場合は、 X サーバは、そのバックグラウンドでウィンドウをタイルします。 ウィンドウのバックグラウンドが定義されていない場合は、 現在のスクリーンの内容は変更されず、 X サーバは、 Expose イベントを 1つも発生しないか、1つ以上の Expose イベントを発生します。 ウィンドウがマップされていない間、バッキングストアが維持されていた場合は、 Expose イベントは 何も発生されません。 バッキングストアが維持される場合は、 フルウィンドウのエクスポージャが常に与えられます。 そうでない場合は、ビジブルリージョンだけが通知されます。 同様のタイリングおよびエクスポージャが、どんな新しいビューアブルな 下位ウィンドウについても行われます。 ウィンドウが InputOutput ウィンドウの場合は、 XMapWindow は、それが表示させる各 InputOutput ウィンドウ上に Expose イベントを発生します。 クライアントがウィンドウをマップし、ペイントする場合、 およびクライアントがイベントの処理を開始する場合、 ウィンドウは 2度ペイントされます。 これを避けるために、 最初に Expose イベントを要求し、それからウィンドウをマップすると、 クライアントは、いつも通りに入力イベントを処理します。 イベントリストは、スクリーン上に現われる各ウィンドウについて Expose を含みます。 Expose イベントへのクライアントの通常の応答は、 ウィンドウをリペイントするということでなければなりません。 一般に、この方法により、より簡単なプログラムを作成でき、 ウィンドウマネージャと適切に相互作用することができます。 .PN XMapWindow は、 BadWindow エラーを生じることがあります。 XMapRaised 関数は、 マップリクエストをもっているウィンドウとそのすべてのサブウィンドウ をマップするという点では、本質的に XMapWindow と同様です。 ただし、 XMapRaised は、指定されたウィンドウを raise して表示することもします。 .PN XMapRaised は、 BadWindow エラーを生じることがあります。 XMapSubwindows 関数は、上部から下部への ( top-to-bottom ) スタック順序で、 指定されたウインドウのすべてのウィンドウをマップします。
 X サーバは、各々の新しく表示されたウィンドウ上に Expose イベントを発生します。 これは、一度に多くのウィンドウをマップするよりもずっと有効です。 なぜならば、サーバは、各々のウィンドウについてというよりも、 すべてのウィンドウについて、ほとんどの作業を行なうために たった 1度必要とされるだけだからです。 .PN XMapSubwindows は、 BadWindow エラーを生じることがあります。

診断

BadWindow
ウインドウ引数の値が、定義されたウィンドウを指さない。

関連事項

XChangeWindowAttributes(3X11), XConfigureWindow(3X11), XCreateWindow(3X11), XDestroyWindow(3X11), XRaiseWindow(3X11), XUnmapWindow(3X11)
Xlib − C Language X Interface

NEWS-OSRelease 3.3