XChangePointerControl(3X11)

名前
XChangePointerControl, XGetPointerControl - ポインタの制御

書式
XChangePointerControl(display, do_accel, do_threshold, accel_numerator,
                        accel_denominator, threshold)
      Display *display;
      Bool do_accel, do_threshold;
      int accel_numerator, accel_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
    アクセラレーションの閾値が返される。

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

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

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

返り値

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

関連項目
Xlib - C Language X Interface