Other Alias
XGetICValues書式
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 を示していない。