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 がゼロの場合も同じエラーになる。

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

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

返り値

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

関連項目
Xlib - C Language X Interface