| 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><ph conkeyref="vbox-conkeyref-phrases/product-name"/> enables you to drag and drop content from the host to the
|
|---|
| 8 | guest, and vice versa. For this to work the latest version of the Guest Additions must be installed on the guest. </p>
|
|---|
| 9 | <p>Drag and drop transparently allows copying or opening files, directories, and even certain clipboard formats from
|
|---|
| 10 | one end to the other. For example, from the host to the guest or from the guest to the host. You then can perform
|
|---|
| 11 | drag and drop operations between the host and a VM, as it would be a native drag and drop operation on the host
|
|---|
| 12 | OS. </p>
|
|---|
| 13 | <p>At the moment drag and drop is implemented for Windows-based and X Window-based systems, both on the host and guest side. As X Window supports many different drag and drop protocols only the most common one, XDND, is supported for now. Applications using other protocols, such as Motif or OffiX, will not be recognized by <ph conkeyref="vbox-conkeyref-phrases/product-name"/>. </p>
|
|---|
| 14 | <p>In the context of using drag and drop, the origin of the data is called the <i>source</i>. That is, where the
|
|---|
| 15 | actual data comes from and is specified. The <i>destination</i> specifies where the data from the source should go
|
|---|
| 16 | to. Transferring data from the source to the destination can be done in various ways, such as copying, moving, or
|
|---|
| 17 | linking. </p>
|
|---|
| 18 | <note>
|
|---|
| 19 | <p>At the moment only copying of data is supported. Moving or linking is not yet implemented. </p>
|
|---|
| 20 | </note>
|
|---|
| 21 | <p>When transferring data from the host to the guest OS, the host in this case is the source, whereas the guest OS
|
|---|
| 22 | is the destination. However, when transferring data from the guest OS to the host, the guest OS this time became
|
|---|
| 23 | the source and the host is the destination. </p>
|
|---|
| 24 | <p>For security reasons drag and drop can be configured at runtime on a per-VM basis either using the <b
|
|---|
| 25 | outputclass="bold">Drag and Drop</b> menu item in the <b outputclass="bold">Devices</b> menu of the virtual
|
|---|
| 26 | machine, or the <userinput>VBoxManage</userinput> command. </p>
|
|---|
| 27 | <p>On Windows hosts, dragging content between UAC-elevated (User Account Control) programs and non UAC-elevated programs isn't allowed. For example, if you start <ph conkeyref="vbox-conkeyref-phrases/product-name"/> with Administrator privileges then dragging to or from Windows Explorer, which runs with regular user privileges by default, is not possible.</p>
|
|---|
| 28 | <p>The following drag and drop modes are available: </p>
|
|---|
| 29 | <ul>
|
|---|
| 30 | <li>
|
|---|
| 31 | <p><b outputclass="bold">Disabled.</b> Disables the drag
|
|---|
| 32 | and drop feature entirely. This is the default when creating a
|
|---|
| 33 | new VM.
|
|---|
| 34 | </p>
|
|---|
| 35 | </li>
|
|---|
| 36 | <li>
|
|---|
| 37 | <p><b outputclass="bold">Host To Guest.</b> Enables drag
|
|---|
| 38 | and drop operations from the host to the guest only.
|
|---|
| 39 | </p>
|
|---|
| 40 | </li>
|
|---|
| 41 | <li>
|
|---|
| 42 | <p><b outputclass="bold">Guest To Host.</b> Enables drag
|
|---|
| 43 | and drop operations from the guest to the host only.
|
|---|
| 44 | </p>
|
|---|
| 45 | </li>
|
|---|
| 46 | <li>
|
|---|
| 47 | <p><b outputclass="bold">Bidirectional.</b> Enables drag
|
|---|
| 48 | and drop operations in both directions: from the host to the
|
|---|
| 49 | guest, and from the guest to the host.
|
|---|
| 50 | </p>
|
|---|
| 51 | </li>
|
|---|
| 52 | </ul>
|
|---|
| 53 | <note>
|
|---|
| 54 | <p>Drag and drop support depends on the frontend being used. At the moment, only the <ph
|
|---|
| 55 | conkeyref="vbox-conkeyref-phrases/vbox-mgr"/> frontend provides this functionality. </p>
|
|---|
| 56 | </note>
|
|---|
| 57 | <p>To use the <userinput>VBoxManage</userinput> command to control the current drag and drop mode, see <xref
|
|---|
| 58 | href="vboxmanage.dita#vboxmanage"/>. The <userinput>modifyvm</userinput> and <userinput>controlvm</userinput>
|
|---|
| 59 | commands enable setting of a VM's current drag and drop mode from the command line. </p>
|
|---|
| 60 | </body>
|
|---|
| 61 | </topic>
|
|---|
