/* $TOG: UTMtransfer.dat /main/5 1999/11/18 16:45:12 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

 */

#) This is the UTMtransfer test.

#) You must see a UTMtransfer window on your screen and a UTMPrim1 window.

#) If you don't see an UTMPrim1 window, please run:

!)

              "UTMPrim1 -u -n&"

C)

#) The following panels test the transfer of the primary selection.

#) When you select an object with a primary selection, and then transfer it 

   (copying it) in an other widget, the following actions should occur:

!)

          1. The convertCallback of the widget owning the primary 

             selection is called multiple times with the selection 

             field set to PRIMARY and different conversion target 

             that this widget supports as a source of data.

          2. The destinationCallback of the widget receiving 

             the transfer is called with the selection field 

             set to PRIMARY and the operation field set to XmCOPY.

#) In our test, the destination widget is the drawing area (red square) in the 

   UTMtransfer window.

C)

#) Select the "Amazing" word in the TextField widget of the UTMPrim1 window.

#) Pulldown the "Edit" menu of the UTMtransfer window and select 

   "Paste (copy)".

#) The list of targets supported by the TextField widget appears in the list

   of the UTMtransfer window.

!)

          TIMESTAMP

          FOREGROUND

          BACKGROUND

          COLORMAP

          CLASS

          NAME

          CLIENT_WINDOW

          _MOTIF_RENDER_TABLE

          _MOTIF_ENCODING_REGISTRY

          COMPOUND_TEXT

          TEXT

          STRING

#) You should see in your term window the calls to the TextField 

   convertCallback, and the call to the drawing area destinationCallback.

#) You can play in the UTMtransfer window, by selecting a target type in the 

   list. When selected, the "Target" name, "Target Value" and target "Type" 

   are updated in the "Target Values" panel.

C)

#) Select the "scream" word in the Text widget of the UTMPrim1 window.

#) As the primary selection change, you will notice in your term window, 

   2 TextField widget convertCallback calls, because this widget just lost

   the focus and the primary selection:

!)

          XmNconvertCallback called for TextField widget.

                  selection         = _MOTIF_DESTINATION

                  conversion target = _MOTIF_LOSE_SELECTION

          XmNconvertCallback called for TextField widget.

                  selection         = PRIMARY

                  conversion target = _MOTIF_LOSE_SELECTION

#) Pulldown the "Edit" menu of the UTMtransfer window and select 

   "Paste (copy)".

#) The list of targets supported by the Text widget appears in the list

   of the UTMtransfer window.

!)

          TIMESTAMP

          FOREGROUND

          BACKGROUND

          COLORMAP

          CLASS

          NAME

          CLIENT_WINDOW

          _MOTIF_RENDER_TABLE

          _MOTIF_ENCODING_REGISTRY

          COMPOUND_TEXT

          TEXT

          STRING

#) You should see in your term window the calls to the Text

   convertCallback, and the call to the drawing area destinationCallback.

#) You can play in the UTMtransfer window, by selecting a target type in the 

   list. When selected, the "Target" name, "Target Value" and target "Type" 

   are updated in the "Target Values" panel.

C)

#) The following panels test the transfer (move) of the primary selection.

#) When you select an object with a primary selection, and then transfer it 

   (moving it) to an other widget, the following actions should occur:

!)

          1. The convertCallback of the widget owning the primary 

             selection is called multiple times with the 

             selection field set to PRIMARY and different 

             conversion target that this widget supports as 

             a source of data.

          2. The destinationCallback of the widget receiving 

             the transfer is called with the selection field 

             set to PRIMARY and the operation field set to XmMOVE.

          3. When the transfer is completed, a delete request 

             is sent to the owner of the primary selection. 

             That is the convertCallback is called with the 

             selection field set to PRIMARY and the conversion 

             target set to DELETE.

#) In our test, the destination widget is the drawing area (red square) in the 

   UTMtransfer window.

C)

#) Select the "Amazing" word in the TextField widget of the UTMPrim1 window.

#) Pulldown the "Edit" menu of the UTMtransfer window and select 

   "Paste (move)".

#) The list of targets supported by the TextField widget appears in the list

   of the UTMtransfer window.

#) You should see in your term window the calls to the TextField 

   convertCallback, the call to the drawing area destinationCallback, and 

   the call to the TextField convertCallback with the DELETE conversion

   target.

#) Notice that the "Amazing" word has been cut from the TextField widget.

#) You can play in the UTMtransfer window, by selecting a target type in the 

   list. When selected, the "Target" name, "Target Value" and target "Type" 

   are updated in the "Target Values" panel.

C)

#) Select the "scream" word in the Text widget of the UTMPrim1 window.

#) Pulldown the "Edit" menu of the UTMtransfer window and select 

   "Paste (move)".

#) The list of targets supported by the Text widget appears in the list

   of the UTMtransfer window.

#) You should see in your term window the calls to the Text

   convertCallback, the call to the drawing area destinationCallback, and 

   the call to the Text convertCallback with the DELETE conversion

   target.

#) Notice that the "scream" word has been cut from the TextField widget.

#) You can play in the UTMtransfer window, by selecting a target type in the 

   list. When selected, the "Target" name, "Target Value" and target "Type" 

   are updated in the "Target Values" panel.

C)

#) Select the "Flavors" word in the TextField widget of the UTMPrim1 window.

#) Press Btn2 and start dragging. Drop it in the drawing area of the

   UTMtransfer window.

#) The list of targets supported by the TextField widget appears in the list

   of the UTMtransfer window.

#) You should see in your term window the calls to the TextField 

   convertCallback with _MOTIF_EXPORT_TARGETS, then the individual conversion

   target calls, and the drawing area destinationCallback, with the

   following parameters:

!)

          selection = _MOTIF_DROP

          operation = XmMOVE

C)

#) Select the "ice" word in the Text widget of the UTMPrim1 window.

#) Press Btn2 and start dragging. Drop it in the drawing area of the

   UTMtransfer window.

#) The list of targets supported by the Text widget appears in the list

   of the UTMtransfer window.

#) You should see in your term window the calls to the Text

   convertCallback with _MOTIF_EXPORT_TARGETS, then the individual conversion

   target calls, and the drawing area destinationCallback, with the

   following parameters:

!)

          selection = _MOTIF_DROP

          operation = XmMOVE

C)

#) Select the "Maple Walnut" item in the List widget of the UTMPrim1 window.

#) Press Btn2 and start dragging. Drop it in the drawing area of the

   UTMtransfer window.

#) The list of targets supported by the List widget appears in the list

   of the UTMtransfer window.

!)

          TIMESTAMP

          FOREGROUND

          BACKGROUND

          COLORMAP

          CLASS

          NAME

          CLIENT_WINDOW

          _MOTIF_RENDER_TABLE

          _MOTIF_ENCODING_REGISTRY

          _MOTIF_COMPOUND_STRING

          COMPOUND_TEXT

          TEXT

          STRING

#) You should see in your term window the calls to the List

   convertCallback with _MOTIF_EXPORT_TARGETS, then the individual conversion

   target calls, and the drawing area destinationCallback, with the

   following parameters:

!)

          selection = _MOTIF_DROP

          operation = XmCOPY

C)

#) Press Btn2 on the PushButton widget and start dragging. 

   Drop it in the drawing area of the UTMtransfer window.

#) The list of targets supported by the PushButton widget appears in the list

   of the UTMtransfer window.

!)

          TIMESTAMP

          FOREGROUND

          BACKGROUND

          COLORMAP

          CLASS

          NAME

          CLIENT_WINDOW

          _MOTIF_RENDER_TABLE

          _MOTIF_ENCODING_REGISTRY

          _MOTIF_COMPOUND_STRING

          COMPOUND_TEXT

          TEXT

          STRING

#) You should see in your term window the calls to the PushButton

   convertCallback with _MOTIF_EXPORT_TARGETS, then the individual conversion

   target calls, and the drawing area destinationCallback, with the

   following parameters:

!)

          selection = _MOTIF_DROP

          operation = XmCOPY

#) You should obtain the same result with the ToggleButton and the Label.

C)

#) Press Btn2 on the label value of the Scale widget and start dragging. 

   Drop it in the drawing area of the UTMtransfer window.

#) The list of targets supported by the Scale widget appears in the list

   of the UTMtransfer window.

!)

          TIMESTAMP

          FOREGROUND

          BACKGROUND

          COLORMAP

          CLASS

          NAME

          CLIENT_WINDOW

          _MOTIF_RENDER_TABLE

          _MOTIF_ENCODING_REGISTRY

          COMPOUND_TEXT

          STRING

#) You should see in your term window the calls to the Scale

   convertCallback with _MOTIF_EXPORT_TARGETS, then the individual conversion

   target calls, and the drawing area destinationCallback, with the

   following parameters:

!)

          selection = _MOTIF_DROP

          operation = XmCOPY

C)

#) Before exiting press the QuitButton in UTMPrim1.

E)