XGetICValues(3) XIC 値の設定・取得を行なう

Other Alias

XSetICValues

書式

char * XSetICValues(ic, ...)

      XIC ic;

char * XGetICValues(ic, ...)

      XIC ic;

引き数

ic
入力コンテクストを指定する。
...
 XIC 値を設定あるいは取得するための可変長引き数リストを指定する。

説明

関数 XSetICValues はエラーが発生しなければ NULL を返す。 それ以外の場合には、設定できなかった最初の引き数の名前を返す。 以下の原因の場合は引き数は設定されないことがある。
  • 引き数が読み取り専用である(例えば XNFilterEvents )。
  • 引き数の名前が認識できない。
  • 実装依存のエラーが発生した。

設定される値は正しいデータであり、かつ引き数の意味によって決まる データ型と適合していなければならない。

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

関数 XGetICValues はエラーが発生しなければ NULL を返す。そうでない場合には、得ることがで きなかった最初の引き数の名前を返す。 引き数が得られない原因を以下に挙げる。

  • 引き数の名前が認識できない。
  • 入力メソッドが実装依存のエラーに出会った。

各IC属性値の引き数(名前の次)は、ICの値が保存される場所を指していなければ ならない。 つまり、IC値の型がTならば、引き数の型は T* でなければならない。 もしT自体がポインタ型であれば、 XGetICValues は実際のデータを格納するメモリを割り当て、そのポインタを返す。 XFree を用いて、このデータを解放するのはクライアントの責任である。 この規則の例外は(前編集とステータスの属性に対する) XNVaNestedList 型のIC値である。 この場合、引き数は XVaNestedList 型でなければならない。 そして、T を T* に変える規則と割り当てた領域を解放する規則は、入れ 子リストの各要素に対して適用される。

返り値

BadAtom
Atom 引き数に対する値が、定義済みの Atom を示していない。
BadColor
Colormap 引き数に対する値が、定義済みの Colormap を示していない。
BadCursor
Cursor 引き数に対する値が、定義済みの Cursor を示していない。
BadPixmap
Pixmap 引き数に対する値が、定義済みの Pixmap を示していない。
BadWindow
Window 引き数に対する値が、定義済みの Window を示していない。