名称

XCreateWindow, XCreateSimpleWindow − ウィンドウを生成する

形式

Window XCreateWindow(display, parent, x, y, width, height, border_width, depth,
                       class, visual, valuemask, attributes)
      Display ∗display;
      Window parent;
      int x, y;
      unsigned int width, height;
      unsigned int border_width;
      int depth;
      unsigned int class;
      Visual ∗visual
      unsigned long valuemask;
      XSetWindowAttributes ∗attributes; Window XCreateSimpleWindow(display, parent, x, y, width, height, border_width,
                             border, background)
      Display ∗display;
      Window parent;
      int x, y;
      unsigned int width, height;
      unsigned int border_width;
      unsigned long border;
      unsigned long background;

引数

attributes値（value mask で指定された）がセットされた構造体を指定します。 value mask は、適切なビットを、構造体内にどの属性が 設定されたかを示すように設定します。

backgroundウィンドウのバックグラウンドピクセル値を指定します。

borderウィンドウのボーダのピクセル値を指定します。

border_width生成されたウィンドウのボーダの幅をピクセル単位で指定します。

class生成されたウィンドウのクラスを指定します。 InputOutput、 InputOnly または CopyFromParent を渡すことができます。 CopyFromParent のクラスは、 親からコピーされることを意味します。

depthウィンドウの深さを指定します。 CopyFromParent の深さは、その深さが親からコピーされることを意味します。

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

parent親ウィンドウを指定します。

valuemaskattributes 引数でどのウィンドウ属性が定義されるか指定します。 このマスクは、有効な属性マスクビットのビット単位の（内包的）論理和です。 valuemask が 0 であれば、属性は無視され、参照されません。

visualビジュアルタイプを指定します。 CopyFromParent のビジュアルは、ビジュアルタイプが親からコピーされることを 意味しています。

width

height生成されたウィンドウの内寸で、ボーダを含まない幅と高さを指定します。

x

yウィンドウボーダの上部左側の外側コーナーで、親ウィンドウのボーダの内側に相対する x - y 座標軸を指定します。

解説

XCreateWindow 関数は、指定された親ウィンドウのアンマップされたサブウィンドウを 生成し、生成されたウィンドウの ID を返し、X サーバが CreateNotify イベントを発生するようにします。 生成されたウィンドウは、同じ親に関するスタック順序の一番上に置かれます。 InputOnly ウィンドウの border_width は 0 でなければなりません。 さもなければ、 BadMatch エラーが生じます。 InputOutput クラスの場合、ビジュアルタイプと深さは、そのスクリーンについて サポートされる組合わせでなければなりません。 さもなければ、 BadMatch エラーが生じます。 深さは親と同じである必要はありませんが、親は InputOnly クラスのウィンドウであってはなりません。 さもなければ、 BadMatch エラーが生じます。 InputOnly ウィンドウの場合、深さが 0 で、ビジュアルがスクリーンで サポートされるものでなければなりません。 いずれの条件も満たされなければ、 BadMatch エラーが生じます。 ただし、親ウィンドウは、どんな深さとクラスでもかまいません。 ウィンドウに対して適切でないウィンドウ属性を指定すると、 BadMatch エラーが生じます。 生成されたウィンドウは、ユーザのディスプレイには まだ表示（マップ）されません。 ウィンドウを表示するには、 XMapWindow をコールします。 新しいウィンドウは、最初、親と同じカーソルを使用します。 XDefineCursor をコールすることで、新しいウィンドウのため新しいカーソルを定義できます。 ウィンドウは、ウィンドウとその先祖すべてがマップされない限り、 表示できません。 また、ウィンドウはどの先祖にも隠されません。 .PN XCreateWindow は、 BadAlloc、 BadColor、 BadCursor、 BadMatch、 BadPixmap、 BadValue および BadWindow エラーを生じることがあります。 XCreateSimpleWindow 関数は、指定された親ウィンドウのアンマップされた InputOutput サブウィンドウを生成し、生成されたウィンドウの ID を返し、 X サーバに、 CreateNotify イベントを発生させます。 生成されたウィンドウは、同じ親に関するスタック順序の一番上に置かれます。 親ウィンドウからはみ出た部分は、クリップされます。 InputOnly ウィンドウの border_width は 0 でなければなりません。 さもなければ、 BadMatch エラーが生じます。 XCreateSimpleWindow は、親から深さ、クラスおよびビジュアルを受け継ぎます。 他のすべてのウィンドウ属性（バックグラウンドとボーダは除く）は、 デフォルト値をとります。 .PN XCreateSimpleWindow は、 BadAlloc、 BadMatch、 BadValue および BadWindow エラーを生じることがあります。

診断

BadAlloc サーバが、要求されたリソースまたはサーバメモリの割当てに失敗した。

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

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

BadMatch InputOnly ウィンドウの値が存在しない。

BadMatch ある引数またはひと組の引数の型と範囲は正しいが、リクエストにより 要求されたその他のなにかが一致しない。

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

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

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

関連事項

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

NEWS-OSRelease 3.3