<!-- $XConsortium: DropSitT.sgm /main/8 1996/09/08 20:41:28 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.MAN215.rsml.1">
<RefMeta>
<RefEntryTitle>XmDropSiteRegister</RefEntryTitle>
<ManVolNum>library call</ManVolNum>
</RefMeta>
<RefNameDiv>
<RefName><Function>XmDropSiteRegister</Function></RefName>
<RefPurpose>A Drag and Drop function that identifies
a drop site and assigns resources that specify its behavior
<IndexTerm>
<Primary>XmDropSiteRegister</Primary>
</IndexTerm><IndexTerm>
<Primary>Drag and Drop functions</Primary>
<Secondary>XmDropSiteRegister</Secondary>
</IndexTerm><IndexTerm>
<Primary>register functions</Primary>
<Secondary>XmDropSiteRegister</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/DragDrop.h>
</FuncSynopsisInfo>
<FuncDef>void <Function>XmDropSiteRegister</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>
</FuncSynopsis>
</RefSynopsisDiv>
<RefSect1>
<Title>DESCRIPTION</Title>
<Para><Function>XmDropSiteRegister</Function> identifies the specified widget or
gadget as a drop site and sets resource values that define
the drop site's behavior. The routine assigns default values
to any resources that are not specified in the argument list.
The toolkit generates a warning message if a drop site is
registered with <SystemItem Class="Resource">XmNdropSiteActivity</SystemItem> set to
<SystemItem Class="Constant">XmDROP_SITE_ACTIVE</SystemItem> and the <SystemItem Class="Resource">XmNdropProc</SystemItem> resource
is NULL.
</Para>
<Para>If the drop site is a descendant of a widget that is registered
as a drop site, the <SystemItem Class="Resource">XmNdropSiteType</SystemItem> resource of the ancestor
drop site must be specified as <SystemItem Class="Constant">XmDROP_SITE_COMPOSITE</SystemItem>. The
ancestor must be registered before the descendant. The drop site
is stacked above all other sibling drop sites already registered.
</Para>
<VariableList>
<VarListEntry>
<Term><Symbol Role="Variable">widget</Symbol></Term>
<ListItem>
<Para>Specifies the ID of the widget to be registered.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term><Symbol Role="Variable">arglist</Symbol></Term>
<ListItem>
<Para>Specifies the argument list.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term><Symbol Role="Variable">argcount</Symbol></Term>
<ListItem>
<Para>Specifies the number of attribute/value pairs in the argument
list (<Symbol Role="Variable">arglist</Symbol>).
</Para>
</ListItem>
</VarListEntry>
</VariableList>
<Para>For a complete definition of DropSite and its associated resources,
see &cdeman.XmDropSite;.
</Para>
</RefSect1>
<RefSect1>
<Title>RELATED</Title>
<Para>&cdeman.XmDisplay;,
&cdeman.XmDropSite;,
&cdeman.XmDropSiteEndUpdate;,
&cdeman.XmDropSiteStartUpdate;,
&cdeman.XmDropSiteUpdate;,
&cdeman.XmDropSiteUnregister;, and
&cdeman.XmScreen;.
</Para>
</RefSect1>
</RefEntry>
<!--fickle 1.09 7/2/95-->
