'\" t
...\" ImGetXIC.sgm /main/9 1996/09/08 20:47:33 rws $
.de P!
.fl
\!!1 setgray
.fl
\\&.\"
.fl
\!!0 setgray
.fl			\" force out current output buffer
\!!save /psv exch def currentpoint translate 0 0 moveto
\!!/showpage{}def
.fl			\" prolog
.sy sed -e 's/^/!/' \\$1\" bring in postscript file
\!!psv restore
.
.de pF
.ie     \\*(f1 .ds f1 \\n(.f
.el .ie \\*(f2 .ds f2 \\n(.f
.el .ie \\*(f3 .ds f3 \\n(.f
.el .ie \\*(f4 .ds f4 \\n(.f
.el .tm ? font overflow
.ft \\$1
..
.de fP
.ie     !\\*(f4 \{\
.	ft \\*(f4
.	ds f4\"
'	br \}
.el .ie !\\*(f3 \{\
.	ft \\*(f3
.	ds f3\"
'	br \}
.el .ie !\\*(f2 \{\
.	ft \\*(f2
.	ds f2\"
'	br \}
.el .ie !\\*(f1 \{\
.	ft \\*(f1
.	ds f1\"
'	br \}
.el .tm ? font underflow
..
.ds f1\"
.ds f2\"
.ds f3\"
.ds f4\"
.ta 8n 16n 24n 32n 40n 48n 56n 64n 72n 
.TH "XmImGetXIC" "library call"
.SH "NAME"
\fBXmImGetXIC\fP \(em An input manager function that obtains an XIC for a widget
.iX "XmImGetXIC"
.iX "input manager functions" "XmImGetXIC"
.SH "SYNOPSIS"
.PP
.nf
#include <Xm/XmIm\&.h>
\fBXIC \fBXmImGetXIC\fP\fR(
\fBWidget \fBwidget\fR\fR,
\fBXmInputPolicy \fBinput_policy\fR\fR,
\fBArgList \fBargs\fR\fR,
\fBCardinal \fBnum_args\fR\fR);
.fi
.SH "DESCRIPTION"
.PP
\fBXmImGetXIC\fP creates and registers an X Input Context (XIC)
with the specified
arguments for \fIwidget\fP\&. If \fBXmINHERIT_POLICY\fP is specified
for \fIinput_policy\fP, a new XIC will be created only if
required to by the arguments or by the \fBVendorShell\fP input policy\&.
Any existing XIC registered with \fIwidget\fP is unregistered\&.
.PP
Refer to the \fBVendorShell\fP reference page for further details\&.
.IP "\fIwidget\fP" 10
Specifies the ID of a widget for which an Input Context is to be
created\&.
.IP "\fIinput_policy\fP" 10
Specifies the type of input policy\&. It accepts the following values:
.RS
.IP "\fBXmINHERIT_POLICY\fP" 10
Inherits the policy from \fBVendorShell\fP\&.
.IP "\fBXmPER_WIDGET\fP" 10
Creates a new XIC for this widget\&.
.IP "\fBXmPER_SHELL\fP" 10
Creates a new XIC for the shell, if needed\&.
.RE
.IP "\fIargs\fP" 10
Specifies an \fBXtArgList\fP parameter to use for creating the XIC\&.
.IP "\fInum_args\fP" 10
Specifies the number of arguments in the \fIargs\fP parameter\&.
.SH "RETURN"
.PP
Returns the created XIC\&.
The application is responsible for freeing the returned XIC
by calling \fBXmImFreeXIC\fP\&.
.SH "RELATED"
.PP
\fBXmImSetXIC\fP(3) and
\fBXmImFreeXIC\fP(3)\&.
...\" created by instant / docbook-to-man, Sun 22 Dec 1996, 20:24