'\" t
...\" ImGetXIM.sgm /main/8 1996/09/08 20:47:41 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 "XmImGetXIM" "library call"
.SH "NAME"
\fBXmImGetXIM\fP \(em An input manager function that retrieves the input
method associated with a specified widget
.iX "XmImGetXIM"
.iX "input manager functions" "XmImGetXIM"
.SH "SYNOPSIS"
.PP
.nf
#include <Xm/XmIm\&.h>
\fBXIM \fBXmImGetXIM\fP\fR(
\fBWidget \fBwidget\fR\fR);
.fi
.SH "DESCRIPTION"
.PP
\fBXmImGetXIM\fP retrieves the XIM data structure representing
the input method that the input manager has opened for the
specified widget\&. If an input method has not been opened
by a previous call to \fBXmImRegister\fP, the first time this
routine is called it opens an input method using the
\fBXmNinputMethod\fP resource for the VendorShell\&. If the
\fBXmNinputMethod\fP is NULL, an input method is opened using the
current locale\&.
If it cannot open an input method, the
function returns NULL\&.
.IP "\fIwidget\fP" 10
Specifies the ID of a widget registered with the input manager
.SH "RETURN"
.PP
Returns the input method for the current locale associated with
the specified widget\&'s input manager; otherwise, returns NULL\&.
The application is responsible for freeing the returned XIM by calling
\fBXmImCloseXIM\fP\&.
.SH "RELATED"
.PP
\fBXmImCloseXIM\fP(3),
\fBXmImGetXIM\fP(3),
\fBXmImMbLookupString\fP(3), and
\fBXmImRegister\fP(3)\&.
...\" created by instant / docbook-to-man, Sun 22 Dec 1996, 20:24