/* $XConsortium: XmeTransfer.dat /main/4 1995/07/17 10:14:51 drk $ */ /* * @OPENGROUP_COPYRIGHT@ * COPYRIGHT NOTICE * Copyright (c) 1993 Open Software Foundation, Inc. * Copyright (c) 1996, 1997, 1998, 1999, 2000 The Open Group * ALL RIGHTS RESERVED (MOTIF). See the file named COPYRIGHT.MOTIF for * the full copyright text. * * This software is subject to an open license. It may only be * used on, with or for operating systems which are themselves open * source systems. You must contact The Open Group for a license * allowing distribution and sublicensing of this software on, with, * or for operating systems which are not Open Source programs. * * See http://www.opengroup.org/openmotif/license for full * details of the license agreement. Any use, reproduction, or * distribution of the program constitutes recipient's acceptance of * this agreement. * * EXCEPT AS EXPRESSLY SET FORTH IN THIS AGREEMENT, THE PROGRAM IS * PROVIDED ON AN "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY * KIND, EITHER EXPRESS OR IMPLIED INCLUDING, WITHOUT LIMITATION, ANY * WARRANTIES OR CONDITIONS OF TITLE, NON-INFRINGEMENT, MERCHANTABILITY * OR FITNESS FOR A PARTICULAR PURPOSE * * EXCEPT AS EXPRESSLY SET FORTH IN THIS AGREEMENT, NEITHER RECIPIENT * NOR ANY CONTRIBUTORS SHALL HAVE ANY LIABILITY FOR ANY DIRECT, * INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL * DAMAGES (INCLUDING WITHOUT LIMITATION LOST PROFITS), HOWEVER CAUSED * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN * ANY WAY OUT OF THE USE OR DISTRIBUTION OF THE PROGRAM OR THE * EXERCISE OF ANY RIGHTS GRANTED HEREUNDER, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGES. */ /* * HISTORY */ This test confirms the functionality of the Xme transfer functions. These functions utilize the Xt selection mechanism to choose the data that is to be transferred. The types of transfers that are tested include: Drag and Drop; Primary selection; Secondary selection; and Clipboard. #) The test cases are run using two modified ExmStringTransfer widgets. For each test case one widget will be the "source" and the other will be the "destination". These terms will be used in the test case instructions and can be loosely interpreted as "initiator" and "receiver". #) Each case will instruct you on how to set up the test using the control panel window. This window includes pulldown menus for each of the test case types. #) Also a "Reset" button is present which will reinitialize the strings in the widgets if you'd like to start the test again. Always reset the widgets before starting a new test case. C) This test validates the operation of the Xme Drag and Drop convenience functions. Drag and Drop is supported by using Button2 to drag the data from the "source" widget to the "destination" widget. #) Place the cursor over one of the widgets and hold button2 down. The cursor should change and the widget should be highlighted. #) Drag the mouse over the destination widget (this widget should now be highlighted). #) Then release the mouse button and the icon should "dissolve" into the destination widget and the data from the source widget will appear. #) Make sure that no error messages are printed in the xterm window. C) This test validates the operation of the Xme Primary selection convenience functions. Primary selection is a mechanism that uses a two step transfer process. First data is selected in the "source" widget (Press Button1, drag mouse, then release Button1), then press Button2 over the "destination" widget. (NOTE: the highlighting code has not been added yet.) #) Choose the "Primary" option in the Test Case pulldown menu located in the control window. Then Press the "Reset" button. #) First, we'll perform a COPY test. Place the cursor over one of the widgets and hold Button1 down, drag the mouse, then release. The xterm will print messages to confirm this action. Place the mouse over the destination widget press Button2 and the data from the source widget should appear. #) Press the "Reset" button in the control panel. #) Now we'll perform a MOVE test. Select the data as in the previous case. Move the mouse to the destination widget and hold down the "Shift" key and at the same time press Button2. The data from the source widget will appear in the destination widget and the source widget will become blank. #) Make sure that no error messages are printed in the xterm window. C) This test validates the operation of the Xme Secondary selection convenience functions. Secondary selection is a mechanism that uses a two step transfer process. First a data destination is selected (using Button2) then data is selected in the "source" widget (Press Button1, drag mouse). Then when Button3 is pressed the transfer occurs. It is important to note that at Button2 must be pressed on the source widget (where the data selection occurs). (NOTE: the underlining code has not been added yet.) #) Choose the "Secondary" option in the Test Case pulldown menu located in the control window. Then Press the "Reset" button. #) First, we'll perform a COPY test. Place the cursor over one of the widgets which is to be the destination and press Button2. Then select the data by pressing Button1 over the other widget. Finally, press Button3 over the same widget where the "selection" occurred. Data in the destination widget will be updated by the data from the source widget. #) Press the "Reset" button in the control panel. #) Now we'll perform a MOVE test. Select the destination widget (Button2) and source data as in the previous case (Button1). Then press Button3 while holding down the "Shift" key. The data from the source wdiget will appear in the destination widget and the source widget will become blank. #) Make sure that no error messages are printed in the xterm window. C) This test validates the operation of the Xme Clipboard convenience functions. This transfer method is perhaps the simplest. By using Button1 we COPY data to the Clipboard and Button2 retrieves the data. The "Shift" modifier performs a MOVE operation when we select the data. #) Choose the "Clipboard" option in the Test Case pulldown menu located in the control window. #) Press the "Reset" button. #) First, we'll perform a COPY test. Place the cursor over one of the widgets which is to be the source widget and press Button1. Then press Button2 over the other widget. Data that was sent to the clipboard will appear on the destination widget. NOTE: this will take longer to appear than previous tests. #) Press the "Reset" button in the control panel. #) Now we'll perform a MOVE test. Select the source data and use the "Shift" key as a modifier (Hold the "Shift" key and click Button1). NOTE: the source widget will become blank. Then press Button2 over the other widget. Data will appear in the destination widget. #) Make sure that no error messages are printed in the xterm window. C) Press Exit to end the test. Goodbye. E)