名称

XClearArea, XClearWindow − 領域またはウィンドウをクリアする

形式

XClearArea(display, w, x, y, width, height, exposures)
      Display ∗display;
      Window w;
      int x, y;
      unsigned int width, height;
      Bool exposures; XClearWindow(display, w)
      Display ∗display;
      Window w;

引数

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

exposuresExpose イベントを発生するか否かを表すブール値を指定します。

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

width

height長方形の寸法である幅と、高さを指定します。

x

yウィンドウの原点に相対する x-y 座標を指定し 、長方形の上部左側のコーナーを指定します。

解説

XClearArea 関数は、ウィンドウのバックグラウンドピクセル、またはピクスマップで指 定された寸法に従い、指定されたウィンドウの長方形の領域をペイントしま す。 サブウィンドウモードは、実質上 ClipByChildren です。 幅が 0 の場合、それはウィンドウの現在の幅から x を引いたものに置換さ れます。 高さが 0 の場合、ウィンドウの現在の高さから y を引いたものに置換され ます。 ウィンドウのバックグラウンドのタイルが定義されていれば、子供がクリッ プした長方形は、このタイルでファイルされます。 ウィンドウのバックグラウンドが None であれば、このウィンドウの内容は変更されません。 いずれの場合にも exposures が True であれば、 ビジブルな長方形、またはバッキングストアに保持されている長方形の リージョンについて、ひとつ以上の Expose イベントが発生します。 クラスが InputOnly であるウィンドウを指定すると、 BadMatch エラーが生じます。 .PN XClearArea は、 BadMatch、 BadValue、 BadWindow のエラーが生じることがあります。 XClearWindow 関数は、指定されたウィンドウの領域全体をクリアします。 それは、 XClearArea (display, w, 0, 0, 0, 0, False) と同じです。 ウィンドウのバックグラウンドのタイルが定義されていれば、長方形は GXcopy 関数、およびすべてが 1 のプレーンマスク (plane-mask) でタイルされま す。 ウィンドウのバックグラウンドが None であれば、ウィンドウの内容は変更されません。 クラスが InputOnly であるウィンドウを指定すると、 BadMatch エラーが生じます。 .PN XClearWindow は、 BadMatch エラーと BadWindow エラーが生じることがあります。

診断

BadMatch InputOnly ウィンドウが Drawable として使用された。

BadValue ある数値が許容範囲を超えた。引数の値の範囲が明示されない限り、引数の 型によって決まる最大の範囲まで指定可能です。オルタネイト選択形式の引 数も、このエラーを生じることがあります。

BadWindow
window 引数の値が、定義された window を指さない。

関連事項

XCopyArea(3X11)
Xlib − C Language X Interface

NEWS-OSRelease 3.3