Section 3: library functions
XmDropSiteStartUpdate — A Drag and Drop function that facilitates processing updates to multiple drop sites Synopsis #include <Xm/DragDrop.h> void XmDropSiteStartUpdate( Widget widget); Description XmDropSiteStartUpdate is used in conjunction with XmDropSiteEndUpdate to process updates to multiple drop sites within the same shell widget. XmDropSiteStartUpdate and XmDropSiteEndUpdate signal the beginning and the end respectively of a series…
XmDropSiteRetrieve — A Drag and Drop function that retrieves resource values set on a drop site Synopsis #include <Xm/DragDrop.h> void XmDropSiteRetrieve( Widget widget, ArgList arglist, Cardinal argcount); Description XmDropSiteRetrieve extracts values for the given resources from the drop site specified by widget. An initiator can also obtain information about the current drop site by passing…
XmDropSiteRegistered — A Drag and Drop function that determines if a drop site has been registered Synopsis #include <Xm/DragDrop.h> Boolean XmDropSiteRegistered( Widget widget); Description XmDropSiteRegistered determines if the specified widget has a drop site registered. If a drop site is registered, this function returns True. widget Specifies the ID of the widget being queried. For…
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 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…
XmDropSiteQueryStackingOrder — A Drag and Drop function that returns the parent, a list of children, and the number of children for a specified widget Synopsis #include <Xm/DragDrop.h> Status XmDropSiteQueryStackingOrder( Widget widget, Widget *parent_return, Widget **child_returns, Cardinal *num_child_returns); Description XmDropSiteQueryStackingOrder obtains the parent, a list of children registered as drop sites, and the number of children…
XmDropSiteManager – Motif-compatible support widget for drag’n’drop Synopsis #include <Xm/DropSMgr.h> XmDropSiteManager XmCreateDropSiteManager Description XmDropSiteManager X Resources Name Class Type Default Access XmNnotifyProc XmCNotifyProc CallbackProc NULL CSG XmNtreeUpdateProc XmCTreeUpdateProc CallbackProc NULL CSG XmNclientData XmCClientData Pointer NULL CSG XmNnotifyProc XmNtreeUpdateProc XmNclientData Class Hierarchy Object(3) XmDropSiteManager(3) Callbacks Convenience Functions See Also
XmDropSiteEndUpdate — A Drag and Drop function that facilitates processing updates to multiple drop sites Synopsis #include <Xm/DragDrop.h> void XmDropSiteEndUpdate( Widget widget); Description XmDropSiteEndUpdate is used in conjunction with XmDropSiteStartUpdate to process updates to multiple drop sites within the same hierarchy. XmDropSiteStartUpdate and XmDropSiteEndUpdate signal the beginning and the end respectively of a series of…
XmDropSiteConfigureStackingOrder — A Drag and Drop function that reorders a stack of widgets that are registered drop sites Synopsis #include <Xm/DragDrop.h> void XmDropSiteConfigureStackingOrder( Widget widget, Widget sibling, Cardinal stack_mode); Description XmDropSiteConfigureStackingOrder changes the stacking order of the drop site specified by widget. The stacking order controls the manner in which drag-under effects are clipped by…
XmDropSite — The DropSite Registry Synopsis #include <Xm/DragDrop.h> Description A client registers a widget or gadget as a drop site using the XmDropSiteRegister function. In addition, this routine defines the behavior and capabilities of a drop site by specifying appropriate resources. For example, the XmNimportTargets and XmNnumImportTargets resources identify respectively the selection target types and…
XmDropDownGetChild — A DropDown function that is used to access a component Synopsis #include <Xm/DropDown.h> Widget XmDropDownGetChild( Widget widget, int child); Description XmDropDownGetChild is used to access a component within a DropDown. The parameters given to the function are the DropDown widget and a value indicating which component to access. widget Specifies the DropDown widget…
XmDropDown — The DropDown widget class Synopsis #include <Xm/DropDown.h> Description The DropDown widget allows the user to select elements from a list of choices, and enter their own values in a text widget. To conserve screen space, the list of choices is shown only when the user selects the down arrow button. The choices may…
XmDrawnButton — The DrawnButton widget class Synopsis #include <Xm/DrawnB.h> Description The DrawnButton widget consists of an empty widget window surrounded by a shadow border. It provides the application developer with a graphics area that can have PushButton input semantics. Callback types are defined for widget exposure and widget resize to allow the application to redraw…
XmDrawingArea — The DrawingArea widget class Synopsis #include <Xm/DrawingA.h> Description DrawingArea is an empty widget that is easily adaptable to a variety of purposes. It does no drawing and defines no behavior except for invoking callbacks. Callbacks notify the application when graphics need to be drawn (exposure events or widget resize) and when the widget…
XmDragStart — A Drag and Drop function that initiates a drag and drop transaction Synopsis #include <Xm/DragDrop.h> Widget XmDragStart( Widget widget, XEvent *event, ArgList arglist, Cardinal argcount); Description XmDragStart initiates a drag operation. This routine returns the DragContext widget that it initializes for the associated drag transaction. The toolkit is responsible for freeing the DragContext…
XmDragOverShell – Motif-compatible DragOverShell widget. Synopsis #include <Xm/DragOverS.h> XmDragOverShell XmCreateDragOverShell Description XmDragOverShell X Resources Name Class Type Default Access XmNoverrideRedirect XmCOverrideRedirect Boolean NULL CSG XmNhotX XmCHot Position NULL CSG XmNhotY XmCHot Position NULL CSG XmNdragOverMode XmCDragOverMode UnsignedChar NULL CSG XmNoverrideRedirect XmNhotX XmNhotY XmNdragOverMode Class Hierarchy Object(3) Rect(3) UnNamedObj(3) Core(3) Composite(3) Shell(3) WMShell(3) VendorShell(3) XmDragOverShell(3) Callbacks…
XmDragIcon — The DragIcon widget class Synopsis #include <Xm/DragDrop.h> Description A DragIcon is a component of the visual used to represent the source data in a drag and drop transaction. During a drag operation, a real or simulated X cursor provides drag-over visuals consisting of a static portion that represents the object being dragged, and…
XmDragContext — The DragContext widget class Synopsis #include <Xm/DragDrop.h> Description DragContexts are special widgets used in drag and drop transactions. A DragContext is implemented as a widget, but a client does not explicitly create a DragContext widget. Instead, a client initiates a drag and drop transaction by calling XmDragStart, and this routine initializes and returns…
XmDragCancel — A Drag and Drop function that terminates a drag transaction Synopsis #include <Xm/DragDrop.h> void XmDragCancel( Widget dragcontext); Description XmDragCancel terminates a drag operation and cancels any pending actions of the specified DragContext. This routine can only be called by the initiator client. dragcontext Specifies the ID of the DragContext widget associated with the…
XmDisplay — The Display widget class Synopsis #include <Xm/Display.h> Description The XmDisplay object is used by the Motif widgets to store information that is specific to a display. It also allows the toolkit to access certain information on widget hierarchies that would otherwise be unavailable. Each client has one XmDisplay object for each display it…
XmDirectionToStringDirection — A function that converts an XmDirection value to an XmStringDirection value Synopsis #include <Xm/Xm.h> XmStringDirection XmDirectionToStringDirection (dir) XmDirection dir; (void) Description XmDirectionToStringDirection converts the specified XmDirection direction value to its equivalent XmStringDirection value. Basically, if the XmDirection value has a horizontal direction specification, that horizontal element is used; otherwise, the XmStringDirection value is…