XChangeWindowAttributes

Section: XLIB FUNCTIONS (3X11)
Updated: Release 6.3
Index xjman/web INDEX
 

名前

XChangeWindowAttributes, XSetWindowBackground, XSetWindowBackgroundPixmap, XSetWindowBorder, XSetWindowBorderPixmap, XSetWindowColormap - ウィンドウ属性を変更  

書式

XChangeWindowAttributes(display, w, valuemask, attributes)

      Display *display;

      Window w;

      unsigned long valuemask;

      XSetWindowAttributes *attributes;

XSetWindowBackground(display, w, background_pixel)

      Display *display;

      Window w;

      unsigned long background_pixel;

XSetWindowBackgroundPixmap(display, w, background_pixmap)

      Display *display;

      Window w;

      Pixmap background_pixmap;

XSetWindowBorder(display, w, border_pixel)

      Display *display;

      Window w;

      unsigned long border_pixel;

XSetWindowBorderPixmap(display, w, border_pixmap)

      Display *display;

      Window w;

      Pixmap border_pixmap;

XSetWindowColormap(display, w, colormap)

      Display *display;

      Window w;

      Colormap colormap;  

引き数

attributes
XSetWindowAttributes 構造体を指定する。valuemasuk の指定に従って、 この構造体から値が取り出される。 マスク値は、構造体にセットされているどの値を取り出すかを示す適切なビッ トを持っていなければならない。
background_pixel
背景色のピクセルを指定する。
background_pixmap
背景のピックスマップ、 ParentRelative, None のいずれかを指定する。
border_pixel
カラーマップ内のエントリーを指定する。
border_pixmap
境界のピックスマップか CopyFromParent を指定する。
display
X サーバへの接続を指定する。
valuemask
引き数 attribute のどのウィンドウ属性が定義されているかを指定する。 マスクは正しいマスクビット値のビットごとの論理和を取ったものである。 valuemask が 0 ならば属性は無視され、参照されない。
w
ウィンドウを指定する。
colormap
カラーマップを指定する。
 

説明

関数 XChangeWindowAttributes は、引き数 valuemask に従って XSetWindowAttributes 構造体のウィンドウ属性を使って、指定したウィンドウの属性を変更する。 背景色を変更しても、ウィンドウの表示内容は変更されない。 ウィンドウとその背景を再描画するには XClearWindow を使用すること。 境界のタイリングの原点が変わるような境界の設定や背景色の設定をすると、 境界は再描画される。 ルートウィンドウの背景を NoneParentRelative に設定すると、背景はデフォルトの背景ピックスマップに戻る。 ルートウィンドウの境界を CopyFromParent に変更すると、境界はデフォルトの境界ピックスマップに戻る。 win-gravity 値の変更は、ウィンドウの現在位置には影響を与えない。 他のウィンドウに隠されているウィンドウの backing-store 値の WhenMappedAlways への変更や、マップされているウィンドウの backing-planes 値、 backing-pixel 値, save-under 値の変更の影響はすぐには現れない。 ウィンドウのカラーマップの変更(つまり新しいカラーマップの定義であり、 既に存在するカラーマップの内容の変更ではない)は ColormapNotify イベントを起こす。 可視のウィンドウのカラーマップの変更の効果はすぐには現れない。これは、 カラーマップがインストールされていないからである( XInstallColormap を参照すること)。 ルートウィンドウのカーソルを None に設定した場合、カーソルはデフォルトのものに戻る。 クライアントは可能な限りカラーマップを共有することが望ましい。

複数のクライアントが、同じウィンドウで入力を選択することができる。 この場合のイベントマスクは別個に管理される。 あるイベントが生成されたとき、これはそのイベントに関係する全てのクライ アントに送られる。 しかし、 SubstructureRedirectMask, ResizeRedirectMask, ButtonPressMask は同時に1つのクライアントだけしか選択できない。 あるクライアントがこれらのイベントマスクを選択しようとしたときに、他の クライアントがすでにこれを選択していた場合は、エラー BadAccess となる。 1つのウィンドウに対して、伝播させないイベントを指定するマスクが1つだけ 存在する。これはクライアントごとに1つではない。

XChangeWindowAttributes はエラー BadAccess, BadColor, BadCursor, BadMatch, BadPixmap, BadValue, BadWindow を起こすことがある。

関数 XSetWindowBackground は、指定したピクセル値をウィンドウの背景にセットする。 背景の変更によりウィンドウの内容が変化することはない。 XSetWindowBackground は指定したピクセル値で塗りつぶされた未定義サイズのピックスマップを使用 する。 InputOnly のウィンドウの背景を変更しようとした場合は、エラー BadMatch となる。

XSetWindowBackground はエラー BadMatch, BadWindow を起こすことがある。

関数 XSetWindowBackgroundPixmap はウィンドウの背景ピックスマップに、指定したピックスマップをセットする。 背景ピックスマップは、明示的な参照がそれ以上なされないことがわかった時 点で、すぐに解放してよい。 ParentRelative が指定された場合、親ウィンドウの背景ピックスマップか使われる。ルートウィ ンドウの場合には、背景ピックスマップはデフォルトのものに戻る。 InputOnly のウィンドウの背景を変更しようとした場合は、エラー BadMatch となる。 背景に None がセットされている場合、ウィンドウの背景は定義されていない。

XSetWindowBackgroundPixmap はエラー BadMatch, BadPixmap, BadWindow を起こすことがある。

関数 XSetWindowBorder は、ウィンドウの境界に指定したピクセル値をセットする。 InputOnly のウィンドウに対してこの操作を行った場合は、エラー BadMatch となる。

XSetWindowBorder はエラー BadMatch, BadWindow を起こすことがある。

関数 XSetWindowBorderPixmap はウィンドウの境界ピックスマップに指定したピックスマップをセットする。 境界ピックスマップへの明示的な参照がなくなれば、すぐにこのピックスマッ プを解放することができる。 CopyFromParent を指定した場合、親ウィンドウの境界ピックスマップのコピーが使われる。 この操作を InputOnly に対して行った場合はエラー BadMatch となる。

XSetWindowBorderPixmap はエラー BadMatch, BadPixmap, BadWindow を返すことがある。

関数 XSetWindowColormap は指定したウィンドウに指定したカラーマップを設定する。 カラーマップはウィンドウと同じビジュアル型でなければならない。 そうでない場合には、エラー BadMatch となる。

XSetWindowColormap はエラー BadColor, BadMatch, BadWindow を起こすことがある。  

返り値

BadAccess
割り当てられていないカラーマップをクライアントが解放しようとした。
BadAccess
クライアントが読み取り専用のカラーマップのエントリーに値を入れようとし た。
BadColor
引き数 Colormap の値が、定義されている Colormap を指していない。
BadCursor
引き数 Cursor の値が、定義されている Cursor を指していない。
BadMatch
引き数や引き数の組は正しい型・範囲を持っているが、そのリクエストが要求する 他の条件に適合できなかった。
BadMatch
InputOnly のウィンドウがこの属性をロックしている。
BadPixmap
引き数 Pixmap の値が、定義されている Pixmap を指していない。
BadValue
指定された数値に、リクエストの許容範囲を越えているものがある。引き数に対 して特定の範囲が指定されていなければ、引き数の型で定義されている全ての範 囲が許される。選択肢として定義されている引き数はこのエラーを起こすことが ある。
BadWindow
引き数 Window の値が、定義されている Window を指していない。
 

関連項目

XConfigureWindow(3X11), XCreateWindow(3X11), XDestroyWindow(3X11), XInstallColormap(3X11), XMapWindow(3X11), XRaiseWindow(3X11), XUnmapWindow(3X11)
Xlib - C Language X Interface


 

Index

名前
書式
引き数
説明
返り値
関連項目

This document was created by man2html, using the manual pages.
Time: 15:55:29 GMT, February 12, 2001