XClearArea(3X11)

名前
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;

引き数

display
    X サーバへの接続を指定する。

exposures
    イベントを生成するかどうかを示す真偽値を指定する。

w   ウィンドウを指定。

width

height
    幅と高さを指定する。 これは長方形のディメンジョンである。

x

y   x, y 座標を指定する。 これはウィンドウの原点に対する相対座標であり、長方形の左上隅を指定する。

説明
関数 は指定したディメンジョンに従って、指定したウィンドウの長方形の領域をウィ ンドウかピックスマップの背景色で塗りつぶす。 subwindow-mode は単に である。 width が 0 ならば、これはウィンドウの現在の幅から x を引いた値に置き 換えられる。 height が 0 ならば、これはウィンドウの現在の高さから y を引いた値に置 き換えられる。 ウィンドウが定義されている背景タイルを持っていれば、子ウィンドウによっ てクリップされる長方形はこのタイルによって埋められる。 ウィンドウの背景色が である場合、ウィンドウの表示内容は変更されない。 いずれの場合も、exposure が ならば、可視であるかバッキングストアに保存されている長方形領域に対して、 1つあるいはそれ以上の イベントが生成される。 クラスが であるウィンドウを指定した場合、エラー となる。

はエラー を起こすことがある。

関数 は指定したウィンドウの全体の領域をクリアするもので、 (display, w, 0, 0, 0, 0, と等価である。 ウィンドウが定義されている背景タイルを持っている場合、長方形は全てが1 であるプレーンマスクと function でタイリングされる。 ウィンドウの背景色が の場合、ウィンドウの内容は変化しない。 クラスが のウィンドウを指定した場合には、エラー となる。

はエラー を起こすことがある。

返り値

のウィンドウが Drawable として指定された。

指定された数値に、リクエストの許容範囲を越えているものがある。引き数に対
    して特定の範囲が指定されていなければ、引き数の型で定義されている全ての範 囲が許される。選択肢として定義されている引き数はこのエラーを起こすことが ある。

引き数 Window の値が、定義されている Window を指していない。

関連項目
XCopyArea(3X11)
Xlib - C Language X Interface