名称

XRecolorCursor, XFreeCursor, XQueryBestCursor - カーソルを操作する

形式

XRecolorCursor(display, cursor, foreground_color, background_color)
      Display ∗display;
      Cursor cursor;
      XColor ∗foreground_color, ∗background_color; XFreeCursor(display, cursor)
      Display ∗display;
      Cursor cursor; Status XQueryBestCursor(display, d, width, height, width_return, height_return)
      Display ∗display;
      Drawable d;
      unsigned int width, height;
      unsigned int ∗width_return, ∗height_return;

引数

background_color
ソースのバックグラウンドの RGB 値を指定します。

cursorカーソルを指定します。

ddrawable を指定します。これは、スクリーンを示しています。

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

foreground_color
ソースのフォアグラウンドの RGB 値を指定します。

width

heightサイズ情報を得るために必要なカーソルの幅と高さを指定します。

width_return

height_return
指定された幅および高さに一番近い、最適な幅と高さを返します。

解説

XRecolorCursor 関数は、指定されたカーソルの色を変更します。 そのカーソルがスクリーン上に表示されている場合は、 その変更を、すぐに目で見ることができます。 XRecolorCursor は、 BadCursor エラーを生じることがあります。 XFreeCursor 関数は、カーソルリソース ID と、 指定されたカーソル間の関係を解除します。 カーソルの記憶領域は、他のリソースがどれも、その領域を参照しなくなった 時、解放されます。 指定されてたカーソル ID は、再度、参照されてはなりません。 XFreeCursor は、 BadCursor エラーを生じることがあります。 他のディスプレイより、より大きなカーソルが利用できるディスプレイも あります。 XQueryBestCursor 関数は、どのサイズのカーソルが、実際にディスプレイ上で利用できるかを 調べる方法を提供します。 XQueryBestCursor は、表示することのできる一番大きなサイズを返します。 アプリケーションは、大きなカーソルをサポートできないディスプレイ上で 用いるためのより小さなカーソルを準備していなければなりません。 XQueryBestCursor は、 BadDrawable エラーを生じることがあります。

診断

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

BadDrawable
Drawable 引数の値が、定義された Window または Pixmap を指さない。

関連事項

XCreateColormap(3X11), XCreateFontCursor(3X11), XDefineCusor(3X11)
Xlib − C Language X Interface

NEWS-OSRelease 4.1C