XmDropSiteRegister(3X)

NAME
     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;


VERSION
     This page documents version 1.2 of the Motif library.

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 argu-
     ment list.  The toolkit generates a warning message if a drop site is  reg-
     istered with XmNdropSiteActivity set to XmDROP_SITE_ACTIVE and the XmNdrop-
     Proc 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 speci-
     fied 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.

     arglistSpecifies 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 Xm-
     DropSite(3X).

RELATED INFORMATION
     XmDisplay(3X), XmDropSite(3X), XmDropSiteEndUpdate(3X), XmDropSiteStartUp-
     date(3X), XmDropSiteUpdate(3X), XmDropSiteUnregister(3X), and XmScreen(3X).

                                                          XmDropSiteRegister(3X)