名称

XLookupKeysym, XRefreshKeyboardMapping, XLookupString, XRebindKeySym − キーボード入力イベントを扱う

形式

KeySym XLookupKeysym(key_event, index)
      XKeyEvent ∗key_event;
      int index; XRefreshKeyboardMapping(event_map)
      XMappingEvent ∗event_map; int XLookupString(event_struct, buffer_return, bytes_buffer, keysym_return, status_in_out)
      XKeyEvent ∗event_struct;
      char ∗buffer_return;
      int bytes_buffer;
      KeySym ∗keysym_return;
      XComposeStatus ∗status_in_out; XRebindKeysym(display, keysym, list, mod_count, string, bytes_string)
      Display ∗display;
      KeySym keysym;
      KeySym list[];
      int mod_count;
      unsigned char ∗string;
      int bytes_string;

引数

buffer_return変換された文字を返します。

bytes_bufferバッファの長さを指定します。 変換の bytes_buffer 以上の変換は返されません。

bytes_string文字列の長さを指定します。

displayX サーバへのコネクションを指定します。

event_map使用するマッピングイベントを指定します。

event_struct使用するキーイベント構造体を指定します。 XKeyPressedEvent または XKeyReleasedEvent を渡せます。

indexイベントの KeyCode 用の KeySyms リストへのインデックスを指定します。

key_eventKeyPress または KeyRelease イベントを指定します。

keysymテストする Keysym を指定します。

keysym_return
この引数が NULL でなければイベントから計算した KeySym を指定します。

listモディファイアとして使用される KeySyms を指定します。

mod_countモディファイアリストのモディファイア数を指定します。

status_in_out
XComposeStatus 構造体または NULL を指定するかまたは返します。

stringXLookupString でコピーされ、返される文字列に対するポインタを指定します。

解説

XLookupKeysym 関数は、与えられたキーボードイベントと指定されたインデックスを使用し、 XKeyPressedEvent または XKeyReleasedEvent 構造体の KeyCode メンバに対応するリストから KeySym を返します。 イベントの KeyCode のため KeySym が定義されなければ、 XLookupKeysym は NoSymbol を返します。 XRefreshKeyboardMapping 関数は、ストアされたモディファイアおよびキーマップ情報をリフレッシュします。 MappingKeyboard または MappingModifier のリクエストメンバによる MappingNotify イベントが発生した場合、通常この関数をコールします。 その結果、キーボードの Xlib の値が更新されます。 XLookupString 関数は、シフト、ロックおよびコントロールに対処するためキーイベントの モディファイアビットを使用し、キーイベントを ISO Latin-1 文字列に マッピングする便利なルーチンです。 この関数は、変換された文字列をユーザーバッファに返します。 また、リバインドされた KeySyms を検出し ( XRebindKeysym 参照 ) 、指定されたバイトを返します。 XLookupString は、タグバッファにストアされた文字列の長さを返します。 ロックモディファイアに対応するキャプスロック KeySym があれば、 XLookupString は、キャプスロック処理を行うためロックモディファイアを解釈します。 もしあれば ( 非 NULL) 、 XComposeStatus 構造体は、compose 処理を実施するため、 XLookupString へのコールにより保存を必要とする状態 ( Xlib に固有の ) を記憶します。 XRebindKeysym 関数は、クライアントにとっての KeySym の意味をリバインドするのに使用できます。 これは、 X サーバのキーを再定義せず、 長い文字列をキーに付加するための簡単な方法となるにすぎません。 適切なモディファイアキーセットを押した場合、また KeySym を使用して変換する場合、 XLookupString はこの文字列を返します。 存在しない KeySym がリバインドされることがあることに注意してください。

関連事項

XStringToKeysym(3X11)
Xlib − C Language X Interface

NEWS-OSRelease 3.3