.\" Copyright \(co 1985, 1986, 1987, 1988, 1989, 1990, 1991, 1994, 1996 X Consortium
.\"
.\" Permission is hereby granted, free of charge, to any person obtaining
.\" a copy of this software and associated documentation files (the
.\" "Software"), to deal in the Software without restriction, including
.\" without limitation the rights to use, copy, modify, merge, publish,
.\" distribute, sublicense, and/or sell copies of the Software, and to
.\" permit persons to whom the Software is furnished to do so, subject to
.\" the following conditions:
.\"
.\" The above copyright notice and this permission notice shall be included
.\" in all copies or substantial portions of the Software.
.\"
.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
.\" OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
.\" MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
.\" IN NO EVENT SHALL THE X CONSORTIUM BE LIABLE FOR ANY CLAIM, DAMAGES OR
.\" OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
.\" ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
.\" OTHER DEALINGS IN THE SOFTWARE.
.\"
.\" Except as contained in this notice, the name of the X Consortium shall
.\" not be used in advertising or otherwise to promote the sale, use or
.\" other dealings in this Software without prior written authorization
.\" from the X Consortium.
.\"
.\" Copyright \(co 1985, 1986, 1987, 1988, 1989, 1990, 1991 by
.\" Digital Equipment Corporation
.\"
.\" Portions Copyright \(co 1990, 1991 by
.\" Tektronix, Inc.
.\"
.\" Permission to use, copy, modify and distribute this documentation for
.\" any purpose and without fee is hereby granted, provided that the above
.\" copyright notice appears in all copies and that both that copyright notice
.\" and this permission notice appear in all copies, and that the names of
.\" Digital and Tektronix not be used in in advertising or publicity pertaining
.\" to this documentation without specific, written prior permission.
.\" Digital and Tektronix makes no representations about the suitability
.\" of this documentation for any purpose.
.\" It is provided ``as is'' without express or implied warranty.
.\" 
.\" Copyright (c) 1998, 2001 The X Japanese Documentation Project.
.\" 
.\" Permission is hereby granted, free of charge, to any person obtaining a
.\" copy of this software and associated documentation files (the
.\" "Software"), to deal in the Software without restriction, including
.\" without limitation the rights to use, copy, modify, merge, publish, dis-
.\" tribute, sublicense, and/or sell copies of the Software, and to permit
.\" persons to whom the Software is furnished to do so, subject to the fol-
.\" lowing conditions:
.\" 
.\" The above copyright notice and this permission notice shall be included
.\" in all copies or substantial portions of the Software.
.\" 
.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
.\" OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABIL-
.\" ITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT
.\" SHALL  THE X JAPANESE DOCUMENTATION PROJECT  BE  LIABLE  FOR  ANY CLAIM,
.\" DAMAGES OR OTHER LIABILITY,  WHETHER IN AN ACTION OF CONTRACT,  TORT OR
.\" OTHERWISE,  ARISING FROM,  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR
.\" THE USE OR OTHER DEALINGS IN THE SOFTWARE.
.\" 
.\" Except as contained in this notice, the name of The X Japanese
.\" Documentation Project shall not be used in advertising or otherwise to
.\" promote the sale, use or other dealings in this Software without prior
.\" written authorization from The X Japanese Documentation Project.
.\" 
.\" X Window System is a trademark of The Open Group.
.\"
.\" Translated Tue Oct 27 00:00:00 JST 1998
.\"           by FUJIWARA Teruyoshi <fujiwara@linux.or.jp>
.\" Corrected by NAKANO Takeo <nakano@apm.seikei.ac.jp>
.\" Updated Mon Oct  8 22:51:11 JST 2001 for XFree86 4.1.0
.\"           by FUJIWARA Teruyoshi <fujiwara@linux.or.jp>
.\"
.\" $XFree86: xc/doc/man/X11/XSICVals.man,v 1.2 2001/01/27 18:20:03 dawes Exp $
.\"
.ds xT X Toolkit Intrinsics \- C Language Interface
.ds xW Athena X Widgets \- C Language X Toolkit Interface
.ds xL Xlib \- C Language X Interface
.ds xC Inter-Client Communication Conventions Manual
.na
.de Ds
.nf
.\\$1D \\$2 \\$1
.ft 1
.\".ps \\n(PS
.\".if \\n(VS>=40 .vs \\n(VSu
.\".if \\n(VS<=39 .vs \\n(VSp
..
.de De
.ce 0
.if \\n(BD .DF
.nr BD 0
.in \\n(OIu
.if \\n(TM .ls 2
.sp \\n(DDu
.fi
..
.de FD
.LP
.KS
.TA .5i 3i
.ta .5i 3i
.nf
..
.de FN
.fi
.KE
.LP
..
.de IN		\" send an index entry to the stderr
..
.de C{
.KS
.nf
.D
.\"
.\"	choose appropriate monospace font
.\"	the imagen conditional, 480,
.\"	may be changed to L if LB is too
.\"	heavy for your eyes...
.\"
.ie "\\*(.T"480" .ft L
.el .ie "\\*(.T"300" .ft L
.el .ie "\\*(.T"202" .ft PO
.el .ie "\\*(.T"aps" .ft CW
.el .ft R
.ps \\n(PS
.ie \\n(VS>40 .vs \\n(VSu
.el .vs \\n(VSp
..
.de C}
.DE
.R
..
.de Pn
.ie t \\$1\fB\^\\$2\^\fR\\$3
.el \\$1\fI\^\\$2\^\fP\\$3
..
.de ZN
.ie t \fB\^\\$1\^\fR\\$2
.el \fI\^\\$1\^\fP\\$2
..
.de hN
.ie t <\fB\\$1\fR>\\$2
.el <\fI\\$1\fP>\\$2
..
.de NT
.ne 7
.ds NO Note
.if \\n(.$>$1 .if !'\\$2'C' .ds NO \\$2
.if \\n(.$ .if !'\\$1'C' .ds NO \\$1
.ie n .sp
.el .sp 10p
.TB
.ce
\\*(NO
.ie n .sp
.el .sp 5p
.if '\\$1'C' .ce 99
.if '\\$2'C' .ce 99
.in +5n
.ll -5n
.R
..
.		\" Note End -- doug kraft 3/85
.de NE
.ce 0
.in -5n
.ll +5n
.ie n .sp
.el .sp 10p
..
.ny0
.TH XSetICValues 3X11 "Release 6.5" "X Version 11" "XLIB FUNCTIONS"
.SH 名前
.\"0 XSetICValues, XGetICValues \- set and obtain XIC values
XSetICValues, XGetICValues \- XIC 値の設定・取得を行なう
.SH 書式
char * XSetICValues\^(\^\fIic\fP\^, ...)
.br
      XIC \fIic\fP\^;
.LP
char * XGetICValues\^(\^\fIic\fP\^, ...)
.br
      XIC \fIic\fP\^;
.SH 引き数
.IP \fIic\fP 1i
.\"0 Specifies the input context.
入力コンテクストを指定する。
.\"0 .ds Al \ to set or get XIC values
.ds Al \ XIC 値を設定あるいは取得するため
.IP ... 1i
.\"0 Specifies the variable length argument list\*(Al.
\*(Alの可変長引き数リストを指定する。
.SH 説明
.\"0 The
.\"0 .ZN XSetICValues
.\"0 function returns NULL if no error occurred; 
関数
.ZN XSetICValues
はエラーが発生しなければ NULL を返す。
.\"0 otherwise,
.\"0 it returns the name of the first argument that could not be set.
それ以外の場合には、設定できなかった最初の引き数の名前を返す。
.\"0 An argument might not be set for any of the following reasons:
以下の原因の場合は引き数は設定されないことがある。
.IP \(bu 5
.\"0 The argument is read-only (for example,
.\"0 .ZN XNFilterEvents ).
引き数が読み取り専用である(例えば
.ZN XNFilterEvents
)。
.IP \(bu 5
.\"0 The argument name is not recognized.
引き数の名前が認識できない。
.IP \(bu 5
.\"0 An implementation-dependent error occurs.
実装依存のエラーが発生した。
.LP
.\"0 Each value to be set must be an appropriate datum,
.\"0 matching the data type imposed by the semantics of the argument.
設定される値は正しいデータであり、かつ引き数の意味によって決まる
データ型と適合していなければならない。
.LP
.\"0 The
.\"0 .ZN XSetICValues
.\"0 can generate
.\"0 .ZN BadAtom ,
.\"0 .ZN BadColor ,
.\"0 .ZN BadCursor ,
.\"0 .ZN BadPixmap ,
.\"0 and
.\"0 .ZN BadWindow
.\"0 errors.
.ZN XSetICValues
は、エラー
.ZN BadAtom ,
.ZN BadColor ,
.ZN BadCursor ,
.ZN BadPixmap ,
.ZN BadWindow
を起こすことがある。
.LP
.\"0 The
.\"0 .ZN XGetICValues
.\"0 function returns NULL if no error occurred; otherwise,
.\"0 it returns the name of the first argument that could not be obtained.
関数
.ZN XGetICValues
はエラーが発生しなければ NULL を返す。そうでない場合には、得ることがで
きなかった最初の引き数の名前を返す。
.\"0 An argument could not be obtained for any of the following reasons:
引き数が得られない原因を以下に挙げる。
.IP \(bu 5
.\"0 The argument name is not recognized.
引き数の名前が認識できない。
.IP \(bu 5
.\"0 The input method encountered an implementation-dependent error.
入力メソッドが実装依存のエラーに出会った。
.LP
.\"0 Each IC attribute value argument (following a name) must point to
.\"0 a location where the IC value is to be stored.
各IC属性値の引き数(名前の次)は、ICの値が保存される場所を指していなければ
ならない。
.\"0 That is, if the IC value is of type T,
.\"0 the argument must be of type T*.
つまり、IC値の型がTならば、引き数の型は T* でなければならない。
.\"0 If T itself is a pointer type,
.\"0 then
.\"0 .ZN XGetICValues
.\"0 allocates memory to store the actual data,
.\"0 and the client is responsible for freeing this data by calling
.\"0 .ZN XFree
.\"0 with the returned pointer.
もしT自体がポインタ型であれば、
.ZN XGetICValues
は実際のデータを格納するメモリを割り当て、そのポインタを返す。
.ZN XFree
を用いて、このデータを解放するのはクライアントの責任である。
.\"0 The exception to this rule is for an IC value of type
.\"0 .ZN XNVaNestedList
.\"0 (for preedit and status attributes).
この規則の例外は(前編集とステータスの属性に対する)
.ZN XNVaNestedList
型のIC値である。
.\"0 In this case,  the argument must also be of type
.\"0 .ZN XVaNestedList .
この場合、引き数は
.ZN XVaNestedList
型でなければならない。
.\"0 Then, the rule of changing type T to T* and freeing the allocated data
.\"0 applies to each element of the nested list.
そして、T を T* に変える規則と割り当てた領域を解放する規則は、入れ
子リストの各要素に対して適用される。
.SH 返り値
.TP 1i
.ZN BadAtom
.\"0 A value for an Atom argument does not name a defined Atom.
Atom 引き数に対する値が、定義済みの Atom を示していない。
.TP 1i
.ZN BadColor
.\"0 A value for a Colormap argument does not name a defined Colormap.
Colormap 引き数に対する値が、定義済みの Colormap を示していない。
.TP 1i
.ZN BadCursor
.\"0 A value for a Cursor argument does not name a defined Cursor.
Cursor 引き数に対する値が、定義済みの Cursor を示していない。
.TP 1i
.ZN BadPixmap
.\"0 A value for a Pixmap argument does not name a defined Pixmap.
Pixmap 引き数に対する値が、定義済みの Pixmap を示していない。
.TP 1i
.ZN BadWindow
.\"0 A value for a Window argument does not name a defined Window.
Window 引き数に対する値が、定義済みの Window を示していない。
.SH 関連項目
XCreateIC(3X11),
XOpenIM(3X11),
XSetICFocus(3X11),
XmbResetIC(3X11)
.br
\fI\*(xL\fP