XmDropSiteRegister(X3mot)


XmDropSiteRegister -- a Drag and Drop function that identifies a drop site and assigns resources that specify its behavior

Synopsis

#include <Xm/DragDrop.h>

void XmDropSiteRegister (widget, arglist, argcount) Widget widget; ArgList arglist; Cardinal argcount;

Description

XmDropSiteRegister 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 XmNdropSiteActivity set to XmDROP_SITE_ACTIVE and the XmNdropProc resource is NULL.

If the drop site is a descendant of a widget that is registered as a drop site, the XmNdropSiteType resource of the ancestor drop site must be specified as XmDROP_SITE_COMPOSITE. The ancestor must be registered before the descendant. The drop site is stacked above all other sibling drop sites already registered.


widget
Specifies the ID of the widget to be registered

arglist
Specifies the argument list

argcount
Specifies the number of attribute/value pairs in the argument list (arglist)

For a complete definition of DropSite and its associated resources, see XmDropSite(X3mot).

References

XmDisplay(X3mot), XmDropSite(X3mot), XmDropSiteEndUpdate(X3mot), XmDropSiteStartUpdate(X3mot), XmDropSiteUpdate(X3mot), XmDropSiteUnregister(X3mot) and XmScreen(X3mot).
25 April 2004
© 2004 The SCO Group, Inc. All rights reserved.
UnixWare 7 Release 7.1.4 - 25 April 2004