| 1 | <?xml version='1.0' encoding='UTF-8'?>
|
|---|
| 2 | <!DOCTYPE topic PUBLIC "-//OASIS//DTD DITA Topic//EN" "topic.dtd">
|
|---|
| 3 | <topic xml:lang="en-us" id="guestadd-dnd">
|
|---|
| 4 | <title>Drag and Drop</title>
|
|---|
| 5 |
|
|---|
| 6 | <body>
|
|---|
| 7 | <p>
|
|---|
| 8 | <ph conkeyref="vbox-conkeyref-phrases/product-name"/> enables you to drag and drop content from the host
|
|---|
| 9 | to the guest, and vice versa. For this to work the latest version
|
|---|
| 10 | of the Guest Additions must be installed on the guest.
|
|---|
| 11 | </p>
|
|---|
| 12 | <p>
|
|---|
| 13 | Drag and drop transparently allows copying or opening files,
|
|---|
| 14 | directories, and even certain clipboard formats from one end to
|
|---|
| 15 | the other. For example, from the host to the guest or from the
|
|---|
| 16 | guest to the host. You then can perform drag and drop operations
|
|---|
| 17 | between the host and a VM, as it would be a native drag and drop
|
|---|
| 18 | operation on the host OS.
|
|---|
| 19 | </p>
|
|---|
| 20 | <p>
|
|---|
| 21 | At the moment drag and drop is implemented for Windows-based and
|
|---|
| 22 | X-Windows-based systems, both on the host and guest side. As
|
|---|
| 23 | X-Windows supports many different drag and drop protocols only the
|
|---|
| 24 | most common one, XDND, is supported for now. Applications using
|
|---|
| 25 | other protocols, such as Motif or OffiX, will not be recognized by
|
|---|
| 26 | <ph conkeyref="vbox-conkeyref-phrases/product-name"/>.
|
|---|
| 27 | </p>
|
|---|
| 28 | <p>
|
|---|
| 29 | In the context of using drag and drop, the origin of the data is
|
|---|
| 30 | called the <i>source</i>. That is, where the actual
|
|---|
| 31 | data comes from and is specified. The
|
|---|
| 32 | <i>destination</i> specifies where the data from the
|
|---|
| 33 | source should go to. Transferring data from the source to the
|
|---|
| 34 | destination can be done in various ways, such as copying, moving,
|
|---|
| 35 | or linking.
|
|---|
| 36 | </p>
|
|---|
| 37 | <note>
|
|---|
| 38 | <p>
|
|---|
| 39 | At the moment only copying of data is supported. Moving or
|
|---|
| 40 | linking is not yet implemented.
|
|---|
| 41 | </p>
|
|---|
| 42 | </note>
|
|---|
| 43 | <p>
|
|---|
| 44 | When transferring data from the host to the guest OS, the host in
|
|---|
| 45 | this case is the source, whereas the guest OS is the destination.
|
|---|
| 46 | However, when transferring data from the guest OS to the host, the
|
|---|
| 47 | guest OS this time became the source and the host is the
|
|---|
| 48 | destination.
|
|---|
| 49 | </p>
|
|---|
| 50 | <p>
|
|---|
| 51 | For security reasons drag and drop can be configured at runtime on
|
|---|
| 52 | a per-VM basis either using the <b outputclass="bold">Drag and
|
|---|
| 53 | Drop</b> menu item in the
|
|---|
| 54 | <b outputclass="bold">Devices</b> menu of the virtual
|
|---|
| 55 | machine, as shown below, or the <userinput>VBoxManage</userinput>
|
|---|
| 56 | command.
|
|---|
| 57 | </p>
|
|---|
| 58 | <fig id="fig-drag-drop-options">
|
|---|
| 59 | <title>Drag and Drop Menu Options</title>
|
|---|
| 60 | <xref href="images/dnd-modes.png" format="png" platform="htmlhelp">
|
|---|
| 61 | <image href="images/dnd-modes.png" width="10cm" placement="break">
|
|---|
| 62 | <alt>Drag and Drop Menu Options</alt>
|
|---|
| 63 | </image>
|
|---|
| 64 | </xref>
|
|---|
| 65 | <image platform="ohc" href="images/dnd-modes.png" width="10cm" placement="break">
|
|---|
| 66 | <alt>Drag and Drop Menu Options</alt>
|
|---|
| 67 | </image>
|
|---|
| 68 | </fig>
|
|---|
| 69 | <p>
|
|---|
| 70 | The following drag and drop modes are available:
|
|---|
| 71 | </p>
|
|---|
| 72 | <ul>
|
|---|
| 73 | <li>
|
|---|
| 74 | <p><b outputclass="bold">Disabled.</b> Disables the drag
|
|---|
| 75 | and drop feature entirely. This is the default when creating a
|
|---|
| 76 | new VM.
|
|---|
| 77 | </p>
|
|---|
| 78 | </li>
|
|---|
| 79 | <li>
|
|---|
| 80 | <p><b outputclass="bold">Host To Guest.</b> Enables drag
|
|---|
| 81 | and drop operations from the host to the guest only.
|
|---|
| 82 | </p>
|
|---|
| 83 | </li>
|
|---|
| 84 | <li>
|
|---|
| 85 | <p><b outputclass="bold">Guest To Host.</b> Enables drag
|
|---|
| 86 | and drop operations from the guest to the host only.
|
|---|
| 87 | </p>
|
|---|
| 88 | </li>
|
|---|
| 89 | <li>
|
|---|
| 90 | <p><b outputclass="bold">Bidirectional.</b> Enables drag
|
|---|
| 91 | and drop operations in both directions: from the host to the
|
|---|
| 92 | guest, and from the guest to the host.
|
|---|
| 93 | </p>
|
|---|
| 94 | </li>
|
|---|
| 95 | </ul>
|
|---|
| 96 | <note>
|
|---|
| 97 | <p>
|
|---|
| 98 | Drag and drop support depends on the frontend being used. At the
|
|---|
| 99 | moment, only the <ph conkeyref="vbox-conkeyref-phrases/vbox-mgr"/> frontend provides this
|
|---|
| 100 | functionality.
|
|---|
| 101 | </p>
|
|---|
| 102 | </note>
|
|---|
| 103 | <p>
|
|---|
| 104 | To use the <userinput>VBoxManage</userinput> command to control the
|
|---|
| 105 | current drag and drop mode, see <xref href="vboxmanage.dita#vboxmanage"/>. The
|
|---|
| 106 | <userinput>modifyvm</userinput> and <userinput>controlvm</userinput>
|
|---|
| 107 | commands enable setting of a VM's current drag and drop mode from
|
|---|
| 108 | the command line.
|
|---|
| 109 | </p>
|
|---|
| 110 | </body>
|
|---|
| 111 | </topic>
|
|---|
