XCreateIC(3X11)

名前
XCreateIC, XDestroyIC, XIMOfIC - 入力コンテクスト(input context)の生成、破棄と入力コンテクストの入力メソッド(input method)の取得

書式
XIC XCreateIC(im, ...)
      XIM im;

void XDestroyIC(ic)
      XIC ic;

XIM XIMOfIC(ic)
      XIC ic;

引き数

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

im  入力メソッドを指定。

... XIC values を設定するため 可変長引き数リストを指定。

説明
関数 は指定された入力メソッド内にコンテクストを生成する。

引き数の一部は生成時には必須であり、これらの引き数が与えられていない場合に は入力コンテクストは生成されない。 必須の引き数は入力スタイル(input style)とテキストコールバックのセット(選 択した入力スタイルがコールバックを必要とする場合)である。 他の入力コンテクストの値は後でセットすることができる。

は入力コンテクストを生成できなかった場合には NULL を返す。 NULL が返されるのは以下の理由のいずれかである。

•   必要な引き数が指定されていない。

•   読み取り専用の引き数(例えば )が指定された。

•   引き数の名前が認識できない。

•   入力メソッドが入力メソッドの実装依存のエラーに遭遇した。

はエラー を起こすことがある。

は指定した入力コンテクストを破棄する。

関数 は指定した入力コンテクストに関連付けられている入力メソッドを返す。

返り値

引き数 Atom の値が、定義されている Atom を示していない。

引き数 Colormap の値が、定義されているカラーマップを示していない。

引き数 Pixmap の値が、定義されているピックスマップを示していない。

引き数 Window の値が、定義されているウィンドウを示していない。

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