XmImSetFocusValues(3X) UNIX System V XmImSetFocusValues(3X)
NAME
XmImSetFocusValues - An input manager function that notifies
an input manager that a widget has received input focus and
updates the input context attributes
SYNOPSIS
#include <Xm/XmIm.h>
void XmImSetFocusValues(
Widget widget,
ArgList arglist,
Cardinal argcount,
);
VERSION
This page documents Motif 2.1.
DESCRIPTION
XmImSetFocusValues notifies the input manager that the
specified widget has received input focus. This function
also updates the attributes of the input context associated
with the widget. The focus window for the XIC is set to the
window of the widget. The arglist argument is a list of
attribute/value pairs for the input context. This function
passes the attributes and values to XICSetValues. The caller
of this routine should pass in only those values that have
changed since the last call to any of these functions;
XmImSetValues, XmImSetFocusValues, XmImVaSetValues, or
XmImVaSetFocusValues. See the description in the
XmImSetValues(3) reference page for a list of associated
resources.
If the previous parameters for the widget's XIC do not allow
the previously registered XIC to be reused, that XIC will be
unregistered, and a new one will be created and registered
with the widget. Note that sharing of data is preserved.
widget Specifies the ID of the widget registered with the
input manager.
arglist Specifies the list of attribute/value pairs to be
passed to XICSetValues. See the description in the
XmImSetValues(3) man page for a description of
resources.
argcount Specifies the number of attribute/values pairs in
the argument list (arglist)
Note that the Text and TextField widgets call the
XmImSetFocusValues function when they receive focus.
Therefore, further calls to the XmImSetFocusValues function
for these widgets are unnecessary.
Page 1 (printed 7/20/06)
XmImSetFocusValues(3X) UNIX System V XmImSetFocusValues(3X)
RELATED
XmImSetValues(3), XmImVaSetFocusValues(3), and
XmImVaSetValues(3).
Page 2 (printed 7/20/06)