書式

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

      Display *display;

      int class;

      Drawable which_screen;

      unsigned int width, height;

      unsigned int *width_return, *height_return;

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

      Display *display;

      Drawable which_screen;

      unsigned int width, height;

      unsigned int *width_return, *height_return;

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

      Display *display;

      Drawable which_screen;

      unsigned int width, height;

      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 の場合は、対象とするスクリーンをドロウアブルで指定する。 TileShape と StippleShape の場合は、ドロウアブルを使ってスクリーンを指示する。これで同時に ウィンドウクラスと深さを指示することもできる。 TileShape と StippleShape に対し、 InputOnly のウィンドウをドロウアブルとして用いることはできない。 これを用いた場合には、エラー BadMatch となる。

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

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

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

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

XQueryBestStipple はエラー BadDrawable か BadMatch を起こすことがある。

返り値

BadMatch

InputOnly のウィンドウがドロウアブルとして使用された。

BadDrawable

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

BadMatch

InputOnly のウィンドウに対する値が存在しない。

BadValue

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