<!-- $XConsortium: GetDragC.sgm /main/8 1996/09/08 20:45:56 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.MAN250.rsml.1">
<RefMeta>
<RefEntryTitle>XmGetDragContext</RefEntryTitle>
<ManVolNum>library call</ManVolNum>
</RefMeta>
<RefNameDiv>
<RefName><Function>XmGetDragContext</Function></RefName>
<RefPurpose>A Drag and Drop function that retrieves the
DragContext widget ID associated with a timestamp
<IndexTerm>
<Primary>XmGetDragContext</Primary>
</IndexTerm><IndexTerm>
<Primary>Drag and Drop functions</Primary>
<Secondary>XmGetDragContext</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, 1992 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/DragC.h>
</FuncSynopsisInfo>
<FuncDef>Widget <Function>XmGetDragContext</Function></FuncDef>
<!--<ParamDef><Replaceable>refwidget, timestamp</Replaceable></ParamDef>-->
<ParamDef>Widget <Parameter>refwidget</Parameter></ParamDef>
<ParamDef>Time <Parameter>timestamp</Parameter></ParamDef>
</FuncSynopsis>
</RefSynopsisDiv>
<RefSect1>
<Title>DESCRIPTION</Title>
<Para><Function>XmGetDragContext</Function> returns the widget ID of the active
DragContext associated with a given display and timestamp. A timestamp
uniquely identifies which DragContext is active when more than
one drag and drop transaction has been initiated on a display. If
the specified timestamp matches a timestamp processed between
the start and finish of a single drag and drop transaction, the
function returns the corresponding DragContext ID.
</Para>
<VariableList>
<VarListEntry>
<Term><Symbol Role="Variable">refwidget</Symbol></Term>
<ListItem>
<Para>Specifies the ID of the widget that the routine uses to identify
the intended display. The function returns the ID of the
DragContext associated with the display value passed by this widget.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term><Symbol Role="Variable">timestamp</Symbol></Term>
<ListItem>
<Para>Specifies a timestamp.
</Para>
</ListItem>
</VarListEntry>
</VariableList>
<Para>For a complete definition of DragContext and its associated resources,
see &cdeman.XmDragContext;.
</Para>
</RefSect1>
<RefSect1>
<Title>RETURN</Title>
<Para>Returns the ID of the DragContext widget that is active for the
specified timestamp. Otherwise, returns NULL if no active
DragContext is found.
</Para>
</RefSect1>
<RefSect1>
<Title>RELATED</Title>
<Para>&cdeman.XmDragContext;.
</Para>
</RefSect1>
</RefEntry>
<!--fickle 1.09 7/2/95-->
