XmbResetIC
Section: XLIB FUNCTIONS (3X11)
Updated: Release 6.6
索引
xjman
名前
XmbResetIC, XwcResetIC, Xutf8ResetIC - 入力コンテクストの状態をリセットする
書式
char * XmbResetIC(ic)
XIC ic;
wchar_t * XwcResetIC(ic)
XIC ic;
char * Xutf8ResetIC(ic)
XIC ic;
引き数
- ic
-
入力コンテクストを指定する。
説明
XIMInitialState
に
XNResetState
が設定されているとき、
XmbResetIC,
XwcResetIC,
Xutf8ResetIC
は入力コンテクストを初期状態にリセットする。
XIMPreserveState
に
XNResetState
が設定されていれば、入力コンテクストの状態は保存される。
いずれの場合も、コンテクスト内でペンディングされている入力は全て削除さ
れる。
入力メソッド(input method)がある場合、入力メソッドには前編集領域
(preedit area)をクリアし、状態を適宜更新することが要求される。
XmbResetIC
や
XwcResetIC,
Xutf8ResetIC
の呼び出しによってフォーカスが変化することはない。
XmbResetIC
の返り値は、現在の前編集文字列(マルチバイト文字列)である。
XwcResetIC
の返り値は、現在の前編集文字列(ワイド文字文字列)である。
Xutf8ResetIC
の返り値は、現在の前編集文字列(UTF-8 文字列)である。
描画されていたり、ユーザから見える状態になっている前編集領域がある場合
には、これらの手続きは NULL でない文字列を返さなくてはならない。
可視状態の前編集領域がない場合は、これらの手続きが NULL を返すか、
NULL でない文字列を返すかは実装依存である。
クライアントは返された文字列を
XFree
を呼んで解放しなければならない。
関数
Xutf8ResetIC
は XFree86 4.0.2 から導入された XFree86 独自の拡張である。この関数が
あるかどうかはマクロ
X_HAVE_UTF8_STRING
で判定できる。
関連項目
XCreateIC(3X11),
XOpenIM(3X11),
XSetICFocus(3X11),
XSetICValues(3X11)
Xlib - C Language X Interface
Index
- 名前
-
- 書式
-
- 引き数
-
- 説明
-
- 関連項目
-
Time: 07:00:57 GMT, January 12, 2009