XmbResetIC(3X11)

名前
XmbResetIC, XwcResetIC, Xutf8ResetIC - 入力コンテクスト(input context)の状態をリセットする

書式
char * XmbResetIC(ic)
      XIC ic;

wchar_t * XwcResetIC(ic)
      XIC ic;

char * Xutf8ResetIC(ic)
      XIC ic;

引き数

ic  入力コンテクストを指定する。

説明
に が設定されているとき、 は入力コンテクストを初期状態にリセットする。 に が設定されていれば、入力コンテクストの状態は保存される。 いずれの場合も、コンテクスト内でペンディングされている入力は全て削除さ れる。 入力メソッド(input method)がある場合、入力メソッドには前編集領域 (preedit area)をクリアし、状態を適宜更新することが要求される。 や の呼び出しでフォーカスが変化することはない。

の返り値は、現在の前編集文字列(マルチバイト文字列)である。 の返り値は、現在の前編集文字列(ワイド文字文字列)である。 の返り値は、現在の前編集文字列(UTF-8 文字列)である。 描画されていたり、ユーザから見える状態になっている前編集領域がある場合 には、これらの手続きは NULL でない文字列を返さなくてはならない。 可視状態の前編集領域がない場合は、これらの手続きが NULL を返すか、 NULL でない文字列を返すかは実装依存である。

クライアントは返された文字列を を呼んで解放しなければならない。

関数 は XFree86 4.0.2 から導入された XFree86 独自の拡張である。この関数が あるかどうかはマクロ で判定できる。

関連項目
XCreateIC(3X11), XOpenIM(3X11), XSetICFocus(3X11), XSetICValues(3X11)
Xlib - C Language X Interface