.\" Copyright \(co 1985, 1986, 1987, 1988, 1989, 1990, 1991, 1994, 1996 X Consortium .\" .\" 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, .\" distribute, sublicense, and/or sell copies of the Software, and to .\" permit persons to whom the Software is furnished to do so, subject to .\" the following 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 .\" MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. .\" IN NO EVENT SHALL THE X CONSORTIUM 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 Consortium 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 Consortium. .\" .\" Copyright \(co 1985, 1986, 1987, 1988, 1989, 1990, 1991 by .\" Digital Equipment Corporation .\" .\" Portions Copyright \(co 1990, 1991 by .\" Tektronix, Inc. .\" .\" Permission to use, copy, modify and distribute this documentation for .\" any purpose and without fee is hereby granted, provided that the above .\" copyright notice appears in all copies and that both that copyright notice .\" and this permission notice appear in all copies, and that the names of .\" Digital and Tektronix not be used in in advertising or publicity pertaining .\" to this documentation without specific, written prior permission. .\" Digital and Tektronix makes no representations about the suitability .\" of this documentation for any purpose. .\" It is provided ``as is'' without express or implied warranty. .\" .\" 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 .\" Corrected by NAKANO Takeo .\" Updated Sun Sep 30 22:05:23 JST 2001 for XFree86 4.1.0 .\" by FUJIWARA Teruyoshi .\" .\" $XFree86: xc/doc/man/X11/XLookKsym.man,v 1.3 2001/02/09 03:47:45 tsi Exp $ .\" .ds xT X Toolkit Intrinsics \- C Language Interface .ds xW Athena X Widgets \- C Language X Toolkit Interface .ds xL Xlib \- C Language X Interface .ds xC Inter-Client Communication Conventions Manual .na .de Ds .nf .\\$1D \\$2 \\$1 .ft 1 .\".ps \\n(PS .\".if \\n(VS>=40 .vs \\n(VSu .\".if \\n(VS<=39 .vs \\n(VSp .. .de De .ce 0 .if \\n(BD .DF .nr BD 0 .in \\n(OIu .if \\n(TM .ls 2 .sp \\n(DDu .fi .. .de FD .LP .KS .TA .5i 3i .ta .5i 3i .nf .. .de FN .fi .KE .LP .. .de IN \" send an index entry to the stderr .. .de C{ .KS .nf .D .\" .\" choose appropriate monospace font .\" the imagen conditional, 480, .\" may be changed to L if LB is too .\" heavy for your eyes... .\" .ie "\\*(.T"480" .ft L .el .ie "\\*(.T"300" .ft L .el .ie "\\*(.T"202" .ft PO .el .ie "\\*(.T"aps" .ft CW .el .ft R .ps \\n(PS .ie \\n(VS>40 .vs \\n(VSu .el .vs \\n(VSp .. .de C} .DE .R .. .de Pn .ie t \\$1\fB\^\\$2\^\fR\\$3 .el \\$1\fI\^\\$2\^\fP\\$3 .. .de ZN .ie t \fB\^\\$1\^\fR\\$2 .el \fI\^\\$1\^\fP\\$2 .. .de hN .ie t <\fB\\$1\fR>\\$2 .el <\fI\\$1\fP>\\$2 .. .de NT .ne 7 .ds NO Note .if \\n(.$>$1 .if !'\\$2'C' .ds NO \\$2 .if \\n(.$ .if !'\\$1'C' .ds NO \\$1 .ie n .sp .el .sp 10p .TB .ce \\*(NO .ie n .sp .el .sp 5p .if '\\$1'C' .ce 99 .if '\\$2'C' .ce 99 .in +5n .ll -5n .R .. . \" Note End -- doug kraft 3/85 .de NE .ce 0 .in -5n .ll +5n .ie n .sp .el .sp 10p .. .ny0 .TH XLookupKeysym 3X11 "Release 6.5" "X Version 11" "XLIB FUNCTIONS" .SH 名前 .\"0 XLookupKeysym, XRefreshKeyboardMapping, XLookupString, XRebindKeySym \- handle keyboard input events in Latin-1 XLookupKeysym, XRefreshKeyboardMapping, XLookupString, XRebindKeySym \- Latin-1 のキーボード入力イベントの処理 .SH 書式 KeySym XLookupKeysym(\^\fIkey_event\fP, \fIindex\fP\^) .br XKeyEvent *\fIkey_event\fP\^; .br int \fIindex\fP\^; .LP XRefreshKeyboardMapping(\^\fIevent_map\fP\^) .br XMappingEvent *\fIevent_map\fP\^; .LP int XLookupString(\^\fIevent_struct\fP, \fIbuffer_return\fP, \fIbytes_buffer\fP, \fIkeysym_return\fP, \fIstatus_in_out\fP\^) .br XKeyEvent *\fIevent_struct\fP\^; .br char *\fIbuffer_return\fP\^; .br int \fIbytes_buffer\fP\^; .br KeySym *\fIkeysym_return\fP\^; .br XComposeStatus *\fIstatus_in_out\fP\^; .LP XRebindKeysym(\^\fIdisplay\fP, \fIkeysym\fP, \fIlist\fP, \fImod_count\fP, \fIstring\fP, \fInum_bytes\fP\^) .br Display *\fIdisplay\fP\^; .br KeySym \fIkeysym\fP\^; .br KeySym \fIlist\fP\^[\^]\^; .br int \fImod_count\fP\^; .br unsigned char *\fIstring\fP\^; .br int \fInum_bytes\fP\^; .SH 引き数 .IP \fIbuffer_return\fP 1i .\"0 Returns the translated characters. トランスレートされた文字が返される。 .IP \fIbytes_buffer\fP 1i .\"0 Specifies the length of the buffer. バッファの大きさを指定する。 .\"0 No more than bytes_buffer of translation are returned. トランスレーションの結果が返される。 bytes_buffer を越えた分は返されない。 .IP \fInum_bytes\fP 1i .\"0 Specifies the number of bytes in the string argument. 引き数 string のバイト数を指定する。 .IP \fIdisplay\fP 1i .\"0 Specifies the connection to the X server. X サーバへの接続を指定する。 .IP \fIevent_map\fP 1i .\"0 Specifies the mapping event that is to be used. 使用するマッピングイベントを指定する。 .IP \fIevent_struct\fP 1i .\"0 Specifies the key event structure to be used. 使用するキーイベント構造体を指定する。 .\"0 You can pass .\"0 .ZN XKeyPressedEvent .\"0 or .\"0 .ZN XKeyReleasedEvent . .ZN XKeyPressedEvent または .ZN XKeyReleasedEvent を指定できる。 .IP \fIindex\fP 1i .\"0 Specifies the index into the KeySyms list for the event's KeyCode. イベントの KeyCode から KeySym を調べるためのリストを示すインデックスを指定する。 .IP \fIkey_event\fP 1i .\"0 Specifies the .\"0 .ZN KeyPress .\"0 or .\"0 .ZN KeyRelease .\"0 event. .ZN KeyPress イベントか .ZN KeyRelease イベントを指定する。 .IP \fIkeysym\fP 1i .\"0 Specifies the KeySym that is to be \*(Fn. .\"\*(Fn となる KeySym を指定する。 再バインドされる KeySym を指定する。 .IP \fIkeysym_return\fP 1i .\"0 Returns the KeySym computed from the event if this argument is not NULL. この引き数が NULL でなければ、イベントから求めた KeySym が返される。 .IP \fIlist\fP 1i .\"0 Specifies the KeySyms to be used as modifiers. モディファイアとして使う KeySym のリストを指定する。 .IP \fImod_count\fP 1i .\"0 Specifies the number of modifiers in the modifier list. モディファイアのリスト内のモディファイアの数を指定する。 .IP \fIstatus_in_out\fP 1i .\"0 Specifies or returns the .\"0 .ZN XComposeStatus .\"0 structure or NULL. .ZN XComposeStatus 構造体か NULL を指定する。 またはこれらが返される。 .IP \fIstring\fP 1i .\"0 Specifies the string that is copied and will be returned by .\"0 .ZN XLookupString . .ZN XLookupString にコピーされ、返される文字列を指定する。 .SH 説明 .\"0 The .\"0 .ZN XLookupKeysym .\"0 function uses a given keyboard event and the index you specified to return .\"0 the KeySym from the list that corresponds to the KeyCode member in the .\"0 .ZN XKeyPressedEvent .\"0 or .\"0 .ZN XKeyReleasedEvent .\"0 structure. 関数 .ZN XLookupKeysym は、指定されたキーボードイベントとユーザが指定したインデックスを使って、 リストから取り出した KeySym を返す。この KeySym は、 .ZN XKeyPressedEvent 構造体と .ZN XKeyReleasedEvent 構造体の keycode メンバに対応する。 .\" fujiwara: 原文では KeyCode だが、Xlib.h の定義では keycode .\"0 If no KeySym is defined for the KeyCode of the event, .\"0 .ZN XLookupKeysym .\"0 returns .\"0 .ZN NoSymbol . イベントの KeyCode に対する KeySym が定義されていなければ、 .ZN XLookupKeysym は .ZN NoSymbol を返す。 .LP .\"0 The .\"0 .ZN XRefreshKeyboardMapping .\"0 function refreshes the stored modifier and keymap information. 関数 .ZN XRefreshKeyboardMapping は、格納されているモディファイアとキーマップの情報を更新する。 .\"0 You usually call this function when a .\"0 .ZN MappingNotify .\"0 event with a request member of .\"0 .ZN MappingKeyboard .\"0 or .\"0 .ZN MappingModifier .\"0 occurs. 通常この関数が呼び出されるのは .ZN MappingNotify イベントが発生して、その request メンバが .ZN MappingKeyboard か .ZN MappingModifier だったときである。 .\"0 The result is to update Xlib's knowledge of the keyboard. 関数を呼び出した結果、Xlib のキーボードの情報が更新される。 .LP .\"0 The .\"0 .ZN XLookupString .\"0 function translates a key event to a KeySym and a string. .ZN XLookupString はキーイベントを KeySym と文字列にトランスレートする。 .\"0 The KeySym is obtained by using the standard interpretation of the .\"0 .ZN Shift , .\"0 .ZN Lock , .\"0 group, and numlock modifiers as defined in the X Protocol specification. KeySym は X プロトコル仕様で定義されている .ZN Shift , .ZN Lock , グループ、numlock モディファイアの標準の解釈を使って取得する。 .\"0 If the KeySym has been rebound (see .\"0 .ZN XRebindKeysym ), .\"0 the bound string will be stored in the buffer. KeySym が再バインドされていた場合( .ZN XRebindKeysym を参照)、バインドされている文字列がバッファに格納される。 .\"0 Otherwise, the KeySym is mapped, if possible, to an ISO Latin-1 character .\"0 or (if the Control modifier is on) to an ASCII control character, .\"0 and that character is stored in the buffer. そうでない場合、可能であれば KeySym は ISO Latin-1 文字か (Control モ ディファイアが有効であれば) ACSII 制御文字にマップされ、その文字がバッ ファに格納される。 .\"0 .ZN XLookupString .\"0 returns the number of characters that are stored in the buffer. .ZN XLookupString はバッファに格納した文字数を返す。 .LP .\"0 If present (non-NULL), .\"0 the .\"0 .ZN XComposeStatus .\"0 structure records the state, .\"0 which is private to Xlib, .\"0 that needs preservation across calls to .\"0 .ZN XLookupString .\"0 to implement compose processing. もし .ZN XComposeStatus 構造体が存在していれば(NULLでなければ)、 この構造体には組み立て処理を行うするための .ZN XLookupString の呼び出しの間で保存が必要な状態が記録される。 この状態は Xlib のプライベートなものである。 .\"0 The creation of .\"0 .ZN XComposeStatus .\"0 structures is implementation-dependent; .ZN XComposeStatus の生成は実装依存である。 .\"0 a portable program must pass NULL for this argument. 移植性を必要とするプログラムでは、この引き数に NULL を渡すべきである。 .LP .\"0 The .\"0 .ZN XRebindKeysym .\"0 function can be used to rebind the meaning of a KeySym for the client. 関数 .ZN XRebindKeysym を使うとクライアントにとっての KeySym の意味を再バインドできる。 .\"0 It does not redefine any key in the X server but merely .\"0 provides an easy way for long strings to be attached to keys. この関数は X サーバのキーを再定義するのではなく、単に長い文字列をキー に割り当てる簡単な方法を提供するものである。 .\"0 .ZN XLookupString .\"0 returns this string when the appropriate set of .\"0 modifier keys are pressed and when the KeySym would have been used for .\"0 the translation. .ZN XLookupString は適切な組合せのモディファイアキーが押された時と、KeySym がトランスレーション に対して用いられた時にこの文字列を返す。 .\"0 No text conversions are performed; テキスト変換は行われない。 .\"0 the client is responsible for supplying appropriately encoded strings. 適切にエンコードした文字列を与えるのはクライアントの責任である。 .\"0 Note that you can rebind a KeySym that may not exist. 存在しない KeySym にも再バインドができる点に注意すること。 .SH 関連項目 XButtonEvent(3X11), XMapEvent(3X11), XStringToKeysym(3X11) .br \fI\*(xL\fP