/* $TOG: UTMPrim1.dat /main/5 1999/11/18 16:45:00 jff $ */
 /*
 * Motif
 *
 * Copyright (c) 1987-2012, The Open Group. All rights reserved.
 *
 * These libraries and programs are free software; you can
 * redistribute them and/or modify them under the terms of the GNU
 * Lesser General Public License as published by the Free Software
 * Foundation; either version 2 of the License, or (at your option)
 * any later version.
 *
 * These libraries and programs are distributed in the hope that
 * they will be useful, but WITHOUT ANY WARRANTY; without even the
 * implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
 * PURPOSE. See the GNU Lesser General Public License for more
 * details.
 *
 * You should have received a copy of the GNU Lesser General Public
 * License along with these librararies and programs; if not, write
 * to the Free Software Foundation, Inc., 51 Franklin Street, Fifth
 * Floor, Boston, MA 02110-1301 USA
 */
/*
 * HISTORY
 */

@) Testing primary selection transfer from TextField.
#) Double-click BSelect in the TextField widget to select a word.
<Ctrl> Bselect at a location disjoint from the primary selection.
Single click BTransfer to paste the current selection at the
insertion cursor. 
One message should be printed indicating that XmNdestinationCallback 
was called for the TextField widget.
At least one message should be printed indicating that the
XmNconvertCallback was called for the TextField widget.
!)
     XmNdestinationCallback called for TextField widget.
          selection = PRIMARY
          operation = XmCOPY

     XmNconvertCallback called for TextField widget.
          selection         = PRIMARY
          conversion target = TEXT
#) Make a selection in the TextField widget again. Single Click BTransfer 
in the Text widget in order to paste the current selection into 
the Text widget. 
One message should be written to the terminal indicating 
that the XmNdestinationCallback was called for the Text widget.
At least one message should be printed indicating that the 
XmNconvertCallback was called for the TextField widget.
!)
     XmNdestinationCallback called for Text widget.
          selection = PRIMARY
          operation = XmCOPY

     XmNconvertCallback called for TextField widget.
          selection         = PRIMARY
          conversion target = TEXT
C)
@) Testing primary selection transfer from Text.
#) Double-click MB1 in the Text widget to select a word. <Ctrl> Bselect at
a location disjoint from the primary selection. Single click BTransfer
to paste the current selection at the insertion cursor.
One message should be printed indicating that 
XmNdestinationCallback was called for the Text widget (selection = PRIMARY,
operation = XmCOPY).
At least one message should be printed indicating that the
XmNconvertCallback was called for the Text widget (selection = PRIMARY,
conversion target = TEXT).

#) Make a selection in the Text widget again. Single Click BTransfer in
the TextField widget in order to paste the current selection into 
the TextField widget. One message should be written to the terminal indicating 
that the XmNdestinationCallback was called for the TextField widget
(selection = PRIMARY, operation = XmCOPY).
At least one message should be printed indicating that the 
XmNconvertCallback was called for the Text widget (selection = PRIMARY,
conversion target = TEXT).

C)
@) The following panel tests the *CopyLink and *PasteLink functions
within each of the text widgets.
@) Check that each time you call the *CopyLink function, the convert
Callback is called 3 times with the following arguments:
!)
        selection         = CLIPBOARD
        conversion target = _MOTIF_CLIPBOARD_TARGETS
        parm              = XmLINK

        selection         = CLIPBOARD
        conversion target = MY_LINK_TARGET

        selection         = CLIPBOARD
        conversion target = _MOTIF_DEFERRED_CLIPBOARD_TARGETS
        parm              = XmLINK
@) Check that each time you call the *PasteLink function, the destination
callback is called 1 time with the following arguments:
!)
        selection = CLIPBOARD
        operation = XmLINK
#) Make a selection in the TextField widget.
Press MB3 in the TextField widget to popup the \"TextField Functions\"
menu. Select XmTextFieldCopyLink from the menu to call this function
with the primary selection.  The TextField convert Callback is called.
<Ctrl> Bselect at a location disjoint from the primary selection. 
Press MB3 in the TextField widget to popup 
the \"TextField Functions\" menu again.
Select XmTextFieldPasteLink from the menu to paste the link information 
at the cursor position. 
The TextField destination Callback is called, resulting in the paste of
the \"<TextField Link>\" string.
#) Make a selection in the Text widget.
Press MB3 in the Text widget to popup the \"Text Functions\" menu.
Select XmTextCopyLink from the menu to call this function
with the primary selection.  The Text convert Callback is called.
<Ctrl> Bselect at a location disjoint from the primary selection. 
Press MB3 in the Text widget to popup the 
\"Text Functions\" menu again.
Select XmTextPasteLink from the menu to paste the link information 
at the cursor position. 
The Text destination Callback is called, resulting in the paste of
the \"<Text Link>\" string.
C)

@) The following panel tests the *CopyLink and *PasteLink functions
between each of the text widgets.

#) Make a selection in the TextField widget.
Press MB3 in the TextField widget to popup the \"TextField Functions\"
menu. Select XmTextFieldCopyLink from the menu to call this function
with the primary selection. The TextField convert Callback is called.
Click BSelect in the Text widget.
Press MB3 in the Text widget to popup the \"Text Functions\" menu. 
Select XmTextPasteLink from the menu to paste the link information
from the TextField widget at the cursor position in the Text widget. 
The Text destination Callback is called, resulting in the paste of
the \"<TextField Link>\" string.

C)

#) Select something in any of the Text widgets.
Then test the link_primary action in TextField and Text
widgets, by clicking  "Ctrl <Key> l". 
#) Verify that the destination callback is called for the widget where you
invoke the action, with the following arguments:
!)
        selection = PRIMARY
        operation = XmLINK

#) Verify that the convert callback is called for the widget where the
selection was done, with the following arguments:
!)
        selection         = PRIMARY
        conversion target = MY_LINK_TARGET


C)

@) Testing secondary selection transfer.
#) Click MB1 in the Text widget where you want your selection to be 
   copied.
#) Pressing <Alt> Btransfer and moving in the TextField, do a secondary
   selection. The text becomes underlined. Release Btransfer.
#) The secondary selection is copied into the Text widget.
#) One message should be printed indicating that XmNdestinationCallback 
   was called for the Text widget.
   At least one message should be printed indicating that the
   XmNconvertCallback was called for the TextField widget.
!)
     XmNdestinationCallback called for Text widget.
          selection = SECONDARY
          operation = XmCOPY

     XmNconvertCallback called for TextField widget.
          selection         = SECONDARY
          conversion target = STRING

#) Do the same for all the different combinations. Verify each time
   that the destinationCallback and the convertCallback are called for 
   the right widget, with the right parameter.

C) 

#) Double-click BSelect on a word in the TextField widget. <Ctrl> BTransfer
should make the selection a drag source.
Verify that a message is printed indicating that XmNconvertCallback has
been called for the TextField widget.
!)
        XmNconvertCallback called for TextField widget.
             selection         = _MOTIF_DROP
             conversion target = _MOTIF_EXPORT_TARGETS

#) Again double-click BSelect on a word in the TextField widget. Simultaneously
press <Ctrl> BTransfer and drag the selection over to the Text widget
and drop it.
Verify that a message is written to the terminal indicating that the
XmNdestinationCallback has been called for the Text widget and that the
XmNconvertCallback has been called for the TextField widget. 
!)
        XmNdestinationCallback called for Text widget.
             selection = _MOTIF_DROP
             operation = XmCOPY

        XmNconvertCallback called for TextField widget.
             selection         = _MOTIF_DROP
             conversion target = STRING

C)

#) Check the convertCallback of the List widget for each of the 
selection policy values. Make a selection in the List widget.
Press MB2 on the List widget selection and drag the selection
to one of the Text widgets. Verify that the XmNconvertCallback
was called for the List widget and the XmNdestinationCallback
is called for the appropriate text widget.
!)
        XmNconvertCallback called for List widget.
             selection         = _MOTIF_DROP
             conversion target = _MOTIF_EXPORT_TARGETS

        XmNdestinationCallback called for TextField widget.
             selection = _MOTIF_DROP
             operation = XmCOPY
 
C) 

@) The following panel tests other primitive widgets as drag sources.

#) Single-click MB2 on the PushButton widget labelled \"Click Here\". 
A message should be written to the terminal indicating that the
XmNconvertCallback has been called for the PushButton widget.
!)
        XmNconvertCallback called for PushButton widget. 
             selection         = _MOTIF_DROP
             conversion target = _MOTIF_EXPORT_TARGETS

#) Single-click MB2 on the ToggleButton widget labelled \"Select This\". 
A message should be written to the terminal indicating that the
XmNconvertCallback has been called for the ToggleButton widget.
!)
        XmNconvertCallback called for ToggleButton widget.
             selection         = _MOTIF_DROP
             conversion target = _MOTIF_EXPORT_TARGETS

#) Single-click MB2 on the label widget named \"Label\". 
A message should be written to the terminal indicating that the
XmNconvertCallback has been called for the Label widget.
!) 
        XmNconvertCallback called for Label widget. 
             selection         = _MOTIF_DROP
             conversion target = _MOTIF_EXPORT_TARGETS

#) Single-click MB2 on the value displayed above the Scale widget. 
A message should be written to the terminal indicating that the
XmNconvertCallback has been called for the Scale widget.
!)
        XmNconvertCallback called for Scale widget. 
             selection         = _MOTIF_DROP
             conversion target = _MOTIF_EXPORT_TARGETS

C)

E)