.\" .\" $XFree86: xc/doc/man/Xi/XChDCtl.man,v 1.2 2001/01/27 18:20:20 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: XChDCtl.man,v 1.3 2000/08/17 19:41:56 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 Sep 28 23:59:23 JST 2001 for XFree86 4.1.0 .\" by FUJIWARA Teruyoshi .\" .ds xL Programming With Xlib .TH XGetDeviceControl 3X11 "Release 6.5" "X Version 11" "X FUNCTIONS" .SH 名前 .\"0 XGetDeviceControl, XChangeDeviceControl \- query and change input device controls XGetDeviceControl, XChangeDeviceControl \- 入力デバイス制御の問い合わせと変更を行なう .SH 書式 XDeviceControl * XGetDeviceControl\^(\^\fIdisplay\fP, \fIdevice\fP\^, \fIcontrol\fP\^) .br Display *\fIdisplay\fP\^; .br XDevice *\fIdevice\fP\^; .br int *\fIcontrolType\fP\^; .br .sp int XChangeDeviceControl\^(\^\fIdisplay\fP, \fIdevice\fP\^, \fIcontrolType\fP\^, \fIcontrol\fP\^) .br Display *\fIdisplay\fP\^; .br XDevice *\fIdevice\fP\^; .br int \fIcontrolType\fP\^; .br XDeviceControl *\fIcontrol\fP\^; .SH 引き数 .TP 15 .I display .\"0 Specifies the connection to the X server. X サーバへの接続を指定する。 .TP 15 .I device .\"0 Specifies the device whose control is to be interrogated or modified. 制御についての問い合わせや変更を行うデバイスを指定する。 .TP 15 .I controlType .\"0 Specifies the type of control to be interrogated or changed. 問い合わせや変更を行う制御のタイプを指定する。 .TP 15 .I control .\"0 Specifies the address of an \fIXDeviceControl\fP structure that contains .\"0 the new values for the Device. デバイスに対する新しい値を格納している \fIXDeviceControl\fP 構造体の アドレスを指定する。 .SH 説明 .\"0 These requests are provided to manipulate those input devices that .\"0 support device control. A \fIBadMatch\fP error will be generated if the .\"0 requested device does not support any device controls. これらのリクエストにより、デバイス制御をサポートしている入力デバイスを 操作できる。 リクエストを出したデバイスがデバイスの制御をサポートしていない場合、 \fIBadMatch\fP エラーが起こる。 .LP .\"0 Valid device control types that can be used with these requests include the .\"0 following: これらのリクエストで使用できる有効なデバイス制御のタイプを以下に示す。 .TP 20 DEVICE_RESOLUTION .\"0 Queries or changes the resolution of valuators on input devices. 入力デバイス上のバリュエータの解像度の問い合わせと変更を行う。 .LP .\"0 The \fIXGetDeviceControl\fP request returns a pointer to an .\"0 \fIXDeviceControl\fP structure. \fIXGetDeviceControl\fP リクエストは \fIXDeviceControl\fP 構造体への ポインタを返す。 .LP .\"0 \fIXGetDeviceControl\fP can generate a \fIBadDevice\fP or .\"0 \fIBadMatch\fP error. \fIXGetDeviceControl\fP はエラー \fIBadDevice\fP, \fIBadMatch\fP を 起こすことがある。 .LP .\"0 The \fIXChangeDeviceControl\fP request modifies the values of one .\"0 control on the specified device. The control is identified by the id .\"0 field of the \fIXDeviceControl\fP structure that is passed with the .\"0 request. \fIXChangeDeviceControl\fP リクエストは、指定したデバイスの1つの制御に 関する値を変更する。制御はリクエストと共に渡される \fIXDeviceControl\fP 構造体の id フィールドによって識別される。 .LP .\"0 \fIXChangeDeviceControl\fP can generate a \fIBadDevice\fP, .\"0 \fIBadMatch\fP, or \fIBadValue\fP error. \fIXChangeDeviceControl\fP はエラー \fIBadDevice\fP, \fIBadMatch\fP, \fIBadValue\fP を起こすことがある。 .SH 構造体 .\"0 Each control is described by a structure specific to that control. それぞれの制御は、その制御に特有の構造体によって記述される。 .\"0 These structures are defined in the file \fIXInput.h\fP. これらの構造体はファイル \fIXInput.h\fP 内で定義されている。 .LP .\"0 \fIXDeviceControl\fP is a generic .\"0 structure that contains two fields that are at the beginning of each class .\"0 of control: \fIXDeviceControl\fP は2つのフィールドを持つ汎用的な構造体である。 この構造体は、それぞれの制御クラスの始め2つのフィールドを持つ。 .LP .DS .nf typedef struct { .br XID class; .br int length; .br } XDeviceControl; .fi .DE .LP .\"0 The \fIXDeviceResolutionState\fP structure defines the information that is .\"0 returned for device resolution for devices with valuators. \fIXDeviceResolutionState\fP 構造体はバリュエータを持つデバイスに対し て、デバイスの解像度について返される情報を定義する。 .LP .DS .nf typedef struct { XID control; int length; int num_valuators; int *resolutions; int *min_resolutions; int *max_resolutions; } XDeviceResolutionState; .fi .DE .LP .\"0 The \fIXDeviceResolutionControl\fP structure defines the attributes that can be .\"0 controlled for keyboard Devices. \fIXDeviceResolutionControl\fP 構造体は、キーボードデバイスに対して 制御できる属性を定義する。 .LP .DS .nf typedef struct { XID control; int length; int first_valuator; int num_valuators; int *resolutions; } XDeviceResolutionControl; .fi .DE .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 some other client has caused the specified device to become .\"0 the X keyboard or X pointer device via the \fIXChangeKeyboardDevice\fP or .\"0 \fIXChangePointerDevice\fP requests. 不正なデバイスが指定された。 指定されたデバイスが存在しないか、クライアントが \fIXOpenInputDevice\fP を使ってオープンしていない。 このエラーは指定したデバイスが、他のクライアントの \fIXChangeKeyboardDevice\fP リクエストや \fIXChangePointerDevice\fP リクエストによって X のキーボードや X のポインタデバイスになった時 にも起こる。 .TP 12 \fIBadMatch\fP .\"0 This error may occur if an \fIXGetDeviceControl\fP request was made specifying .\"0 a device that has no controls or an \fIXChangeDeviceControl\fP request was .\"0 made with an \fIXDeviceControl\fP structure that contains an invalid Device .\"0 type. It may also occur if an invalid combination of mask bits is specified .\"0 (\fIDvKey\fP but no \fIDvAutoRepeatMode\fP for keyboard Devices), or if an .\"0 invalid KeySym is specified for a string Device. このエラーは、制御できないデバイスを指定して \fIXGetDeviceControl\fP リクエストを行なった時や、不正なデバイスのタイプを持つ \fIXDeviceControl\fP 構造体で \fIXChangeDeviceControl\fP リクエストを 行った時に起こる。 また、このエラーはマスクビットの不正な組合せが指定されたとき(キーボード デバイスに対して \fIDvKey\fP を指定しているが \fIDvAutoRepeatMode\fP が指定されていない時)や文字列デバイスに対して 不正な KeySym が指定されたときにも起こる。 .TP 12 \fIBadValue\fP .\"0 Some numeric value falls outside the range of values accepted by the .\"0 \fIXChangeDeviceControl\fP request. 指定された数値の中に、\fIXChangeDeviceControl\fP リクエストの許容範囲を 越えているものがある。 .\"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 関連項目 .br \fI\*(xL\fP