書式

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 で判定できる。