XQueryBestSize(3) 効果的なサイズを決定する

Other Alias

XQueryBestTile, XQueryBestStipple

書式

Status XQueryBestSize(display, class, which_screen, width, height, width_return, height_return)

      Display *display;

      int class;

      Drawable which_screen;

      unsigned int widthheight;

      unsigned int *width_return, *height_return;

Status XQueryBestTile(display, which_screen, width, height, width_return, height_return)

      Display *display;

      Drawable which_screen;

      unsigned int widthheight;

      unsigned int *width_return, *height_return;

Status XQueryBestStipple(display, which_screen, width, height, width_return, height_return)

      Display *display;

      Drawable which_screen;

      unsigned int widthheight;

      unsigned int *width_return, *height_return;

引き数

class
問い合わせる対象のクラスを指定する。 TileShape, CursorShape, StippleShape のいずれかを指定する。
display
X サーバへの接続を指定する。
width

height
幅と高さを指定する。
which_screen
スクリーン上の任意のドロウアブルを指定する。
width_return

height_return
オブジェクトの幅と高さが返される。これはディスプレイのハードウェアの サポートが最も効果的になる値である。

説明

関数 XQueryBestSize は指定したサイズに対して、最善かまたはそれにできるだけ近いサイズを返す。 CursorShape に対しては、このサイズは which_screen で指定したスクリーン上で全体を表 示できる最大のサイズである。 TileShape に対しては、これは最も速くタイリングできるサイズである。 StippleShape に対しては、これは最も速くスティプルを適用できるサイズである。 CursorShape の場合は、対象とするスクリーンをドロウアブルで指定する。 TileShapeStippleShape の場合は、ドロウアブルを使ってスクリーンを指示する。これで同時に ウィンドウクラスと深さを指示することもできる。 TileShapeStippleShape に対し、 InputOnly のウィンドウをドロウアブルとして用いることはできない。 これを用いた場合には、エラー BadMatch となる。

XQueryBestSize はエラー BadDrawable, BadMatch, BadValue を起こすことがある。

XQueryBestTile は which_screen として指定したスクリーン上で最善かそれにできるだけ近 いサイズ(つまり最も速くタイリングできるサイズ)を返す。 ドロウアブルを使ってスクリーンを指示する。これで同時にウィンドウクラス と深さを示すこともできる。 InputOnly のウィンドウをドロウアブルとして指定した場合は、エラー BadMatch となる。

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

関数 XQueryBestStipple は、 which_screen として指定したスクリーン上で最善のサイズか、それに できるだけ近いサイズ、つまり最も速くスティプルできるサイズを返す。 ドロウアブルを使ってスクリーンを指示する。これで同時にウィンドウクラス と深さを示すこともできる。 InputOnly のウィンドウをドロウアブルとして指定した場合は、エラー BadMatch となる。

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

返り値

BadMatch
InputOnly のウィンドウがドロウアブルとして使用された。
BadDrawable
引き数 Drawable の値が、定義されている Window や Pixmap を指していない。
BadMatch
InputOnly のウィンドウに対する値が存在しない。
BadValue
指定された数値に、リクエストの許容範囲を越えているものがある。引き数に対 して特定の範囲が指定されていなければ、引き数の型で定義されている全ての範 囲が許される。選択肢として定義されている引き数はこのエラーを起こすことが ある。