XCreateIC(3) 入力コンテクスト(input context)の生成、破棄と入力コンテクストの入力メソッド(input method)の取得

Other Alias

XDestroyIC, XIMOfIC

書式

XIC XCreateIC(im, ...)

      XIM im;

void XDestroyIC(ic)

      XIC ic;

XIM XIMOfIC(ic)

      XIC ic

引き数

ic
入力コンテクストを指定。
im
入力メソッドを指定。
...
 XIC values を設定するため 可変長引き数リストを指定。

説明

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

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

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

  • 必要な引き数が指定されていない。
  • 読み取り専用の引き数(例えば XNFilterEvents )が指定された。
  • 引き数の名前が認識できない。
  • 入力メソッドが入力メソッドの実装依存のエラーに遭遇した。

XCreateIC はエラー BadAtom, BadColor, BadPixmap, BadWindow を起こすことがある。

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

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

返り値

BadAtom
引き数 Atom の値が、定義されている Atom を示していない。
BadColor
引き数 Colormap の値が、定義されているカラーマップを示していない。
BadPixmap
引き数 Pixmap の値が、定義されているピックスマップを示していない。
BadWindow
引き数 Window の値が、定義されているウィンドウを示していない。