.\" .\" $XFree86: xc/doc/man/Xi/XSeBMap.man,v 1.2 2001/01/27 18:20:21 dawes Exp $ .\" .\" .\" Copyright ([\d,\s]*) by Hewlett-Packard Company, Ardent Computer, .\" .\" Permission to use, copy, modify, distribute, and sell this documentation .\" for any purpose and without fee is hereby granted, provided that the above .\" copyright notice and this permission notice appear in all copies. .\" Ardent, and Hewlett-Packard make no representations about the .\" suitability for any purpose of the information in this document. It is .\" provided \`\`as is'' without express or implied warranty. .\" .\" $Xorg: XSeBMap.man,v 1.3 2000/08/17 19:41:57 cpqbld Exp $ .\" .\" Copyright (c) 1998, 2001 The X Japanese Documentation Project. .\" .\" Permission is hereby granted, free of charge, to any person obtaining a .\" copy of this software and associated documentation files (the .\" "Software"), to deal in the Software without restriction, including .\" without limitation the rights to use, copy, modify, merge, publish, dis- .\" tribute, sublicense, and/or sell copies of the Software, and to permit .\" persons to whom the Software is furnished to do so, subject to the fol- .\" lowing conditions: .\" .\" The above copyright notice and this permission notice shall be included .\" in all copies or substantial portions of the Software. .\" .\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS .\" OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABIL- .\" ITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT .\" SHALL THE X JAPANESE DOCUMENTATION PROJECT BE LIABLE FOR ANY CLAIM, .\" DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR .\" OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR .\" THE USE OR OTHER DEALINGS IN THE SOFTWARE. .\" .\" Except as contained in this notice, the name of The X Japanese .\" Documentation Project shall not be used in advertising or otherwise to .\" promote the sale, use or other dealings in this Software without prior .\" written authorization from The X Japanese Documentation Project. .\" .\" X Window System is a trademark of The Open Group. .\" .\" Translated Tue Oct 27 00:00:00 JST 1998 .\" by FUJIWARA Teruyoshi .\" Updated Fri Oct 5 01:06:04 JST 2001 for XFree86 4.1.0 .\" by FUJIWARA Teruyoshi .\" .ds xL Programming With Xlib .TH XSetDeviceButtonMapping 3X11 "Release 6.5" "X Version 11" "X FUNCTIONS" .SH 名前 .\"0 XSetDeviceButtonMapping, XGetDeviceButtonMapping \- query or change device button mappings XSetDeviceButtonMapping, XGetDeviceButtonMapping \- デバイスのボタン割り当ての問い合わせと変更を行なう .SH 書式 int XSetDeviceButtonMapping\^(\^\fIdisplay\fP, \fIdevice\fP, \fImap\fP, \fInmap\fP\^) .br Display *\fIdisplay\fP\^; .br XDevice *\fIdevice\fP\^; .br unsigned char \fImap\fP\^[]\^; .br int \fInmap\fP\^; .sp int XGetDeviceButtonMapping\^(\^\fIdisplay\fP, \fIdevice\fP, \fImap_return\fP, \fInmap\fP\^) .br Display *\fIdisplay\fP\^; .br XDevice *\fIdevice\fP\^; .br unsigned char \fImap_return\fP\^[]\^; .br int \fInmap\fP\^; .SH 引き数 .TP 12 .I display .\"0 Specifies the connection to the X server. X サーバへの接続を指定する。 .TP 12 .I device .\"0 Specifies the device whose button mapping is to be queried or changed. ボタンの割り当ての問い合わせあるいは変更を行なうデバイスを指定する。 .TP 12 .I map .\"0 Specifies the mapping list. 割り当てリストを指定する。 .TP 12 .I map_return .\"0 Returns the mapping list. 割り当てリストが返される。 .TP 12 .I nmap .\"0 Specifies the number of items in the mapping list. 割り当てリスト中の要素数を指定する。 .SH 説明 .\"0 The \fIXSetDeviceButtonMapping\fP .\"0 request sets the mapping of the specified device. \fIXSetDeviceButtonMapping\fP リクエストは指定したデバイスの割り当てを設定する。 .\"0 If it succeeds, the X server generates a .\"0 \fIDeviceMappingNotify\fP event, and .\"0 \fIXSetDeviceButtonMapping\fP returns \fIMappingSuccess\fP. 成功した場合には、X サーバは \fIDeviceMappingNotify\fP イベントを生成し、 \fIXSetDeviceButtonMapping\fP は \fIMappingSuccess\fP を返す。 .\"0 Element map[i] defines the logical button number for the physical button .\"0 i+1. 要素 map[i] は物理的なボタン i+1 に対する論理的なボタン番号を定義する。 .\"0 The length of the list must be the same as .\"0 \fIXGetDeviceButtonMapping\fP .\"0 would return, or a \fIBadValue\fP .\"0 error results. リストの長さは \fIXGetDeviceButtonMapping\fP が返す値と同じでなければならず、そうでない場合はエラー \fIBadValue\fP となる。 .\"0 A zero element disables a button, and elements are not restricted in .\"0 value by the number of physical buttons. 要素が1つもない場合はボタンが無効となる。また、要素の値は物理的な ボタンの数の制約は受けない。 .\"0 However, no two elements can have the same nonzero value, .\"0 or a \fIBadValue\fP error results. しかし、0 以外の同じ値を持つ要素が 2 つあってはならない。あった場合に はエラー \fIBadValue\fP となる。 .\"0 If any of the buttons to be altered are logically in the down state, .\"0 \fIXSetDeviceButtonMapping\fP returns \fIMappingBusy\fP, .\"0 and the mapping is not changed. 変更しようとするボタンのいずれかが論理的に押された状態ならば、 \fIXSetDeviceButtonMapping\fP は \fIMappingBusy\fP を返し、割り当て は変更されない。 .LP .\"0 \fIXSetDeviceButtonMapping\fP .\"0 can generate \fIBadDevice\fP, \fIBadMatch\fP, and \fIBadValue\fP errors. \fIXSetDeviceButtonMapping\fP はエラー \fIBadDevice\fP, \fIBadMatch\fP, \fIBadValue\fP を起こすこと がある。 .LP .\"0 The \fIXGetDeviceButtonMapping\fP .\"0 request returns the current mapping of the specified device. \fIXGetDeviceButtonMapping\fP リクエストは指定したデバイスの現在の割り当てを返す。 .\"0 Buttons are numbered starting from one. ボタンの番号は1から始まる。 .\"0 \fIXGetDeviceButtonMapping\fP .\"0 returns the number of physical buttons actually on the device. \fIXGetDeviceButtonMapping\fP は、デバイス上の実際の物理的なボタン数を返す。 .\"0 The nominal mapping for a device is map[i]=i+1. デバイスに対する名前の対応は map[i] = i+1 である。 .\"0 The nmap argument specifies the length of the array where the device .\"0 mapping is returned, and only the first nmap elements are returned .\"0 in map_return. 引き数 nmap はデバイスの割り当てが返される配列の長さを指定する。 最初の nmap 個の要素だけが map_return に返される。 .LP .\"0 \fIXGetDeviceButtonMapping\fP .\"0 can generate \fIBadDevice\fP or \fIBadMatch\fP errors. \fIXGetDeviceButtonMapping\fP はエラー \fIBadDevice\fP , \fIBadMatch\fP を起こすことがある。 .SH 返り値 .TP 12 \fIBadDevice\fP .\"0 An invalid device was specified. The specified device does not exist or has .\"0 not been opened by this client via \fIXOpenInputDevice\fP. This error may .\"0 also occur if the specified device is the X keyboard or X pointer device. 不正なデバイスが指定された。指定したデバイスが存在しないか、クライアン トが \fIXOpenInputDevice\fP でオープンしていない。指定したデバイスが X のキーボードデバイスか X のポインタデバイスである場合にも、このエラー が起こる。 .TP 12 \fIBadMatch\fP .\"0 This error may occur if an \fIXGetDeviceButtonMapping\fP or .\"0 \fIXSetDeviceButtonMapping\fP request was made .\"0 specifying a device that has no buttons. このエラーはボタンの無いデバイスに対して \fIXGetDeviceButtonMapping\fP リクエストや \fIXSetDeviceButtonMapping\fP リクエストを行ったとき起こ ることがある。 .TP 12 \fIBadValue\fP .\"0 Some numeric value falls outside the range of values accepted by the request. .\"0 Unless a specific range is specified for an argument, the full range defined .\"0 by the argument's type is accepted. Any argument defined as a set of .\"0 alternatives can generate this error. 指定された数値に、リクエストの許容範囲を越えているものがある。引き数に対 して特定の範囲が指定されていなければ、引き数の型で定義されている全ての範 囲が許される。選択肢として定義されている引き数はこのエラーを起こすことが ある。 .SH 関連項目 XChangeDeviceKeyboardControl(3X), .br XChangeDeviceKeyMapping(3X) .br XChangeDeviceModifierMapping(3X) .br .br \fI\*(xL\fP