As a source of data, Container also supports the following standard Motif targets:

As a destination for data, Container supports only the dropping of items being dragged from the same widget. Subclasses and the XmNdestinationCallback procedures are responsible for any other data transfers to the widget.

If the application sets XmNselectedObjects to an array of widgets, those array elements that are valid Container items are selected.

A pointer to the following structure is passed to callbacks for XmNdefaultActionCallback and XmNselectionCallback.

typedef struct
{
        int 
reason;
        XEvent 
* event;
        WidgetList 
selected_items;
        int 
selected_item_count;
        unsigned char 
auto_selection_type;
} XmContainerSelectCallbackStruct;

A pointer to the following structure is passed to the XmNconvertCallback procedures:

typedef struct
{
        int 
reason;
        XEvent  *
event;
        Atom 
selection;
        Atom 
target;
        XtPointer 
source_data;
        XtPointer 
location_data;
        int 
flags;
        XtPointer 
parm;
        int 
parm_format;
        unsigned long 
parm_length;
        int 
status;
        XtPointer 
value;
        Atom 
type;
        int 
format;
        unsigned long 
length;
} XmConvertCallbackStruct;

When selection is CLIPBOARD and target is _MOTIF_CLIPBOARD_TARGETS or _MOTIF_DEFERRED_CLIPBOARD_TARGETS, the value is the requested operation (XmCOPY, XmMOVE, or XmLINK).

A pointer to the following callback structure is passed to the XmNdestinationCallback procedures:

typedef struct
{
        int 
reason;
        XEvent  *
event;
        Atom 
selection;
        XtEnum 
operation;
        int 
flags;
        XtPointer 
transfer_id;
        XtPointer 
destination_data;
        XtPointer 
location_data;
        Time 
time;
} XmDestinationCallbackStruct;

The Container button event translations are modified when Display's XmNenableBtn1Transfer resource does not have a value of XmOFF (in other words, it is either XmBUTTON2_TRANSFER or XmBUTTON2_ADJUST). This option allows the actions for selection and transfer to be integrated on Btn1, and the actions for extending the selection can be bound to Btn2. The actions for Btn1 that are defined in the preceding list still apply when the Btn1 event occurs over text that is not selected. The following actions apply when the Btn1 event occurs over text that is selected:

When Display's XmNenableBtn1Transfer resource has a value of XmBUTTON2_ADJUST, the following actions apply:

Otherwise, this action sets the selection state of all items between the anchor item and the item under the pointer to the selection state of the anchor item. The location cursor is moved to the item under the pointer. If XmNautomaticSelection is XmAUTO_SELECT, the XmNselectionCallback(s) is called with either XmCR_MULTIPLE_SELECT or XmCR_EXTENDED_SELECT as the reason depending on XmNselectionPolicy, and with auto_selection_type XmAUTO_CHANGE.

Otherwise, processing depends on the value of XmNselectionPolicy as follows:

Otherwise, if the pointer is over an item and XmNselectionTechnique is not XmMARQUEE, this action toggles the selection state of that item. The item becomes the anchor item for further selection. If XmNselectionTechnique is XmMARQUEE, XmMARQUEE_EXTEND_START, or XmMARQUEE_EXTEND_BOTH this action sets the start point for the Marquee rectangle. If XmNselectionTechnique is XmMARQUEE_EXTEND_START or XmMARQUEE_EXTEND_BOTH and the pointer is over an item, this action draws the Marquee rectangle around the item. If XmNautomaticSelection is XmAUTO_SELECT, the XmNselectionCallback(s) is called with either XmCR_MULTIPLE_SELECT or XmCR_EXTENDED_SELECT as the reason, depending on XmNselectionPolicy, and with auto_selection_type XmAUTO_BEGIN.

If the pointer is no longer over the current anchor item, this action toggles the current anchor item and then toggles the item under the pointer (if any) and makes it the new anchor item for further processing. If XmNautomaticSelection is XmAUTO_SELECT and a change in any item's selection state is made, the XmNselectionCallback(s) is called with reason XmCR_BROWSE_SELECT and auto_selection_type XmAUTO_MOTION.

If no Marquee rectangle start point is set and the pointer is over an item, processing depends on the XmNlayoutType resource. The anchor item from the previous action is used. If XmNlayoutType is XmSPATIAL, the selection state of the item under the pointer is toggled to match the selection state of the anchor item. If XmNlayoutType is XmOUTLINE or XmDETAIL, the selection state of all items between the anchor item and the item under the pointer are toggled to match the selection state of the anchor item.

If XmNautomaticSelection is XmAUTO_SELECT and a change in any item's selection state is made, the XmNselectionCallback(s) is called with reason XmCR_MULTIPLE_SELECT and auto_selection_type XmAUTO_MOTION.

Otherwise, if XmNautomaticSelection is XmNO_AUTO_SELECT, XmNselectionCallback(s) is called with either XmCR_MULTIPLE_SELECT or XmCR_EXTENDED_SELECT as the reason depending on XmNselectionPolicy. If XmNautomaticSelection is XmAUTO_SELECT and no change is made in any item's selection state by this action, XmNselectionCallback(s) is called with either XmCR_MULTIPLE_SELECT or XmCR_EXTENDED_SELECT as the reason depending on XmNselectionPolicy and auto_selection_type XmAUTO_CHANGE. If XmNautomaticSelection is XmAUTO_SELECT and this action makes no change in any item's selection state, XmNselectionCallback(s) is called with either XmCR_MULTIPLE_SELECT or XmCR_EXTENDED_SELECT as the reason depending on XmNselectionPolicy and auto_selection_type XmAUTO_NO_CHANGE.

Otherwise, the ContainerPrimaryCopy() , ContainerPrimaryLink() , or ContainerPrimaryMove() action is invoked, depending on the value of the operation parameter saved by ContainerStartTransfer() .

If the argument is Left or Right and the layout is right to left, then the setting of the XmNoutlineState value is reversed from that described in the preceding paragraph.

Simply returns if XmNlayoutType is XmSPATIAL.

If the selection policy is XmSINGLE_SELECT or XmBROWSE_SELECT, this action returns. If XmNlayoutType is XmSPATIAL, this action returns.

If the selection policy is XmMULTIPLE_SELECT, this action sets the selection state of all items between the anchor item and the location cursor to the selection state of the anchor item.

If the selection policy is XmEXTENDED_SELECT and the Container is in Normal Mode, this action deselects all items and selects all items between the anchor item and the location cursor. If the selection policy is XmEXTENDED_SELECT and the Container is in Add Mode, this action sets the selection state of all items between the anchor item and the location cursor to the selection state of the anchor item.

XmNselectionCallback is called with reason XmCR_MULTIPLE_SELECT or XmCR_EXTENDED_SELECT depending on XmNselectionPolicy.

If the selection policy is XmSINGLE_SELECT or XmBROWSE_SELECT, this action returns. If XmNlayoutType is XmSPATIAL, this action returns.

This action moves the location cursor one item in the indicated direction, if possible. If the value of the argument string is First or Last , this action moves the location cursor to the indicated item. For other values of the argument string, the location cursor is not affected.

If the selection policy is XmMULTIPLE_SELECT, this action sets the selection state of all items between the anchor item and the location cursor to the selection state of the anchor item.

If the selection policy is XmEXTENDED_SELECT and the Container is in Normal Mode, this action deselects all items and selects all items between the anchor item and the location cursor. If the selection policy is XmEXTENDED_SELECT and the Container is in Add Mode, this action sets the selection state of all items between the anchor item and the location cursor to the selection state of the anchor item.

XmNselectionCallback is called with reason XmCR_MULTIPLE_SELECT or XmCR_EXTENDED_SELECT depending on XmNselectionPolicy.

If XmNselectionPolicy is XmBROWSE_SELECT, or if XmNselectionPolicy is XmEXTENDED_SELECT and the Container is in Normal Mode, this action deselects all items, selects the item at the location cursor, and calls XmNselectionCallback with the reason depending on XmNselectionPolicy.

If the selection policy is XmSINGLE_SELECT or XmBROWSE_SELECT, this action deselects all items and selects the item at the location cursor.

If the selection policy is XmMULTIPLE_SELECT, this action toggles the selection state of the item at the location cursor. This item becomes the anchor item for further selections.

If the selection policy is XmEXTENDED_SELECT and the Container is in Normal Mode, this action deselects all items and selects the item at the location cursor. If the selection policy is XmEXTENDED_SELECT and the Container is in Add Mode, this action toggles the selection state of the item at the location cursor. The selected/toggled item becomes the anchor item for further selections.

XmNselectionCallback is called with the reason depending on XmNselectionPolicy.

If XmNselectionPolicy is XmMULTIPLE_SELECT or XmEXTENDED_SELECT, this action selects all items.

XmNselectionCallback is called with the reason depending on the value of XmNselectionCallback.

Unless default drag and drop behavior has been overridden by a XmNconvertCallback procedure, if the drop operation occurs within the Container, then the item(s) being dragged are relocated at the position of the drop operation. If the item targeted by the Drag operation is not in the selected state, then only that item is moved. If the item is in the selected state, however, all items in the selected state are moved.