<!-- $XConsortium: ImSetFoc.sgm /main/10 1996/09/08 20:48:08 rws $ -->
<!-- (c) Copyright 1995 Digital Equipment Corporation. -->
<!-- (c) Copyright 1995 Hewlett-Packard Company. -->
<!-- (c) Copyright 1995 International Business Machines Corp. -->
<!-- (c) Copyright 1995 Sun Microsystems, Inc. -->
<!-- (c) Copyright 1995 Novell, Inc. -->
<!-- (c) Copyright 1995 FUJITSU LIMITED. -->
<!-- (c) Copyright 1995 Hitachi. -->

<RefEntry Id="CDEMMA.MAN269.rsml.1">
<RefMeta>
<RefEntryTitle>XmImSetFocusValues</RefEntryTitle>
<ManVolNum>library call</ManVolNum>
</RefMeta>
<RefNameDiv>
<RefName><Function>XmImSetFocusValues</Function></RefName>
<RefPurpose>An input manager function that notifies an input manager that a widget
has received input focus and updates the input context attributes
<IndexTerm>
<Primary>XmImSetFocusValues</Primary>
</IndexTerm><IndexTerm>
<Primary>input manager functions</Primary>
<Secondary>XmImSetFocusValues</Secondary>
</IndexTerm></RefPurpose>
</RefNameDiv>
<!---->
<!-- @OSF_COPYRIGHT@-->
<!-- COPYRIGHT NOTICE-->
<!-- Copyright (c) 1990, 1991, 1992, 1993 Open Software Foundation, Inc.-->
<!-- ALL RIGHTS RESERVED (MOTIF). See the file named COPY.MOTIF.DOC for-->
<!-- the full copyright text.-->
<!---->
<!-- HISTORY-->
<!---->
<!-- **-->
<!-- **-->
<!-- **  (c) Copyright 1989, 1990 by Open Software Foundation, Inc.-->
<!-- **      All Rights Reserved.-->
<!-- **-->
<!-- **  (c) Copyright 1987, 1988, 1989, by Hewlett-Packard Company-->
<!-- **-->
<!-- **  (c) Copyright 1987, 1988 by Digital Equipment Corporation,-->
<!-- **      Maynard, MA.  All Rights Reserved.-->
<!-- **-->
<!-- **-->
<RefSynopsisDiv>
<FuncSynopsis>
<FuncSynopsisInfo>#include &lt;Xm/XmIm.h>
</FuncSynopsisInfo>
<FuncDef>void <Function>XmImSetFocusValues</Function></FuncDef>
<!--<ParamDef><Replaceable>widget, arglist, argcount</Replaceable></ParamDef>-->
<ParamDef>Widget <Parameter>widget</Parameter></ParamDef>
<ParamDef>ArgList <Parameter>arglist</Parameter></ParamDef>
<ParamDef>Cardinal <Parameter>argcount</Parameter></ParamDef>
<ParamDef></ParamDef>
</FuncSynopsis>
</RefSynopsisDiv>
<RefSect1>
<Title>DESCRIPTION</Title>
<Para><Function>XmImSetFocusValues</Function> 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
<Symbol Role="Variable">arglist</Symbol> argument is a list of attribute/value pairs for the input
context. This function passes the attributes and values to
<Symbol>XICSetValues</Symbol>. The caller of this routine should pass in
only those values that have changed since the last call to any of
these functions; <Function>XmImSetValues</Function>, <Function>XmImSetFocusValues</Function>,
<Function>XmImVaSetValues</Function>, or <Function>XmImVaSetFocusValues</Function>. See the
description in the &cdeman.XmImSetValues; reference page for a list of
associated resources.
</Para>
<Para>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.
</Para>
<VariableList>
<VarListEntry>
<Term><Symbol Role="Variable">widget</Symbol></Term>
<ListItem>
<Para>Specifies the ID of the widget registered with the input manager.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term><Symbol Role="Variable">arglist</Symbol></Term>
<ListItem>
<Para>Specifies the list of attribute/value pairs to be passed to
<Symbol>XICSetValues</Symbol>. See the description in the &cdeman.XmImSetValues;
man page for a description of resources.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term><Symbol Role="Variable">argcount</Symbol></Term>
<ListItem>
<Para>Specifies the number of attribute/values pairs in the argument
list (<Symbol Role="Variable">arglist)</Symbol>
</Para>
</ListItem>
</VarListEntry>
</VariableList>
<Para>Note that the Text and TextField widgets call the
<Function>XmImSetFocusValues</Function> function when they receive focus. Therefore,
further calls to the <Function>XmImSetFocusValues</Function> function for these
widgets are unnecessary.
</Para>
</RefSect1>
<RefSect1>
<Title>RELATED</Title>
<Para>&cdeman.XmImSetValues;,
&cdeman.XmImVaSetFocusValues;, and
&cdeman.XmImVaSetValues;.
</Para>
</RefSect1>
</RefEntry>
<!--fickle 1.09 7/2/95-->
