XSetPointerMapping(3X11)

名前
XSetPointerMapping, XGetPointerMapping - ポインタの設定の操作

書式
int XSetPointerMapping(display, map, nmap)
      Display *display;
      unsigned char map[];
      int nmap;

int XGetPointerMapping(display, map_return, nmap)
      Display *display;
      unsigned char map_return[];
      int nmap;

引き数

display
    X サーバへの接続を指定。

map マッピングリストを指定。

map_return
    マッピングリストが返される。

nmap
    マッピングリスト内のアイテム数を指定。

説明
関数 はポインタのマッピングをセットする。 成功した場合には X サーバは イベントを生成し、 は を返す。 要素 map[i] は物理ボタン i+1 に対する論理的なボタン番号を定義する。 リストの長さは が返す値と同じでなければならない。そうでない場合には、エラー となる。 要素の値がゼロならばボタンは使えなくなる。要素の値は物理的なボタン数に は制限されない。 しかし、2つの要素がゼロでない同じ値を持つことはできない。同じ値になっ た場合には エラーとなる。 いずれかのボタンの押された状態が論理的に変わった場合、 は を返し、マッピングは変化しない。

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

関数 はポインタの現在のマッピングを返す。 ポインタのボタンには1から始まる番号が付けられる。 はポインタに実際に付いている物理的なボタンの数を返す。 ポインタに対する名目的なマッピングは map[i]=i+1 である。 引き数 nmap はポインタのマッピングが返される配列の長さを指定する。 最初の nmap 個の要素だけが map_return に返される。

返り値

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

関連項目
XChangeKeyboardControl(3X11), XChangeKeyboardMapping(3X11)
Xlib - C Language X Interface