<!-- $XConsortium: ImVaSetF.sgm /main/9 1996/09/08 20:48:51 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.MAN274.rsml.1">
<RefMeta>
<RefEntryTitle>XmImVaSetFocusValues</RefEntryTitle>
<ManVolNum>library call</ManVolNum>
</RefMeta>
<RefNameDiv>
<RefName><Function>XmImVaSetFocusValues</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>XmImVaSetFocusValues</Primary>
</IndexTerm><IndexTerm>
<Primary>input manager functions</Primary>
<Secondary>XmImVaSetFocusValues</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>XmImVaSetFocusValues</Function></FuncDef>
<!--<ParamDef><Replaceable>widget, arg...</Replaceable></ParamDef>-->
<ParamDef>Widget <Parameter>widget</Parameter></ParamDef>
</FuncSynopsis>
</RefSynopsisDiv>
<RefSect1>
<Title>DESCRIPTION</Title>
<Para><Function>XmImVaSetFocusValues</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. 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>XmImVaSetValues</Function>,
<Function>XmImVaSetFocusValues</Function>, <Function>XmImSetValues</Function>, or <Function>XmImSetFocusValues</Function>.
See the description in the &cdeman.XmImSetValues; reference page for a list of
associated resources.
</Para>
<Para>This routine uses the ANSI C variable-length argument list (varargs) calling
conventions. The variable-length argument list consists of groups
of arguments each of which contains an attribute followed by the
value of the attribute. The last argument in the list must be NULL
</Para>
<Para>Note that the List and TextField widgets call the
<Function>XmImVaSetFocusValues</Function> function when they receive focus. Therefore,
further calls to the <Function>XmImVaSetFocusValues</Function> function for these
widgets are unnecessary.
</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>
</VariableList>
<Para>For more information on variable-length argument lists, see the
X Toolkit Intrinsics documentation.
</Para>
</RefSect1>
<RefSect1>
<Title>RELATED</Title>
<Para>&cdeman.XmImSetFocusValues;,
&cdeman.XmImSetValues;, and
&cdeman.XmImVaSetValues;.
</Para>
</RefSect1>
</RefEntry>
<!--fickle 1.09 7/2/95-->
