XGetPointerControl(3) ポインタの制御

Other Alias

XChangePointerControl

書式

XChangePointerControl(display, do_accel, do_threshold, accel_numerator,

                        accel_denominatorthreshold)

      Display *display;

      Bool do_acceldo_threshold;

      int accel_numeratoraccel_denominator;

      int threshold;

XGetPointerControl(display, accel_numerator_return, accel_denominator_return,

                       threshold_return)

      Display *display;

      int *accel_numerator_return, *accel_denominator_return;

      int *threshold_return;

引き数

accel_denominator
アクセラレーションの倍率の分母を指定する。
accel_denominator_return
アクセラレーションの倍率の分母が返される。
accel_numerator
アクセラレーションの倍率の分子を指定する。
accel_numerator_return
アクセラレーションの倍率の分子が返される。
display
X サーバへの接続を指定する。
do_accel
引き数 accel_numerator や accel_denominator の値を使うかどうか制御する真 偽値を指定する。
do_threshold
引き数 threshold の値を使うかどうか制御する真偽値を指定する。
threshold
アクセラレーションの閾値を指定する。
threshold_return
アクセラレーションの閾値が返される。

説明

関数 XChangePointerControl は、ポインティングデバイスがどのように動くか定義する。 分母で表現されるアクセラレーションは移動量にかける倍率である。 例えば 3/1 を指定すると、ポインタは通常の 3 倍の速さで移動する。 X サーバによって、端数は任意に丸められることがある。 ポインタが一度に閾値の個数以上のピクセル移動し、引き数 threshold の値を 越える量を移動しようとした場合に限って、アクセラレーションは有効となる。 値に -1 を指定するとデフォルト値に戻る。 ポインタの値をセットするには、引き数 do_accel と do_threshold は True でなければならない。そうでない場合には、パラメータは変化しない。 負の値(-1 を除く)の場合には、エラー BadValue となる。 引き数 accel_denominator が 0 の場合も同じエラーになる。

XChangePointerControl はエラー BadValue を起こすことがある。

関数 XGetPointerControl は、ポインタのアクセラレーションの倍率と閾値の現在の値を返す。

返り値

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