Método Folder.MoveHere

Mueve un elemento o elementos a esta carpeta.

Sintaxis

Folder.MoveHere(
  vItem,
  [ vOptions ]
)

Parámetros

vItem [in]

Tipo: Variant

Elemento o elementos que se van a mover. Puede ser una cadena que representa un nombre de archivo, un objeto FolderItem o un objeto FolderItems .

vOptions [in, optional]

Tipo: Variant

Opciones para la operación de traslado. Este valor puede ser cero o una combinación de los valores siguientes. Estos valores se basan en las marcas definidas para su uso con el miembro fFlags de la estructura SHFILEOPSTRUCT de C++. Estas marcas no se definen como tal para Visual Basic, VBScript o JScript, por lo que debe definirlas usted mismo o usar sus equivalentes numéricos.

(4)

No mostrar un cuadro de diálogo de progreso.

(8)

Asigne al archivo un nombre nuevo en una operación de movimiento, copia o cambio de nombre si ya existe un archivo con el nombre de destino.

(16)

Responda con "Sí a todo" para cualquier cuadro de diálogo que se muestre.

(64)

Conserve la información de deshacer, si es posible.

(128)

Realice la operación en archivos solo si se especifica un nombre de archivo comodín (*.*).

(256)

Mostrar un cuadro de diálogo de progreso, pero no mostrar los nombres de archivo.

(512)

No confirme la creación de un nuevo directorio si la operación requiere que se cree una.

(1024)

No muestre una interfaz de usuario si se produce un error.

(2048)

Versión 4.71. No copie los atributos de seguridad del archivo.

(4096)

Solo funcionan en el directorio local. No funcione de forma recursiva en subdirectorios.

(9182)

Versión 5.0. No mueva archivos conectados como un grupo. Mueva solo los archivos especificados.

Valor devuelto

Este método no devuelve ningún valor.

Comentarios

Nota

No todos los métodos se implementan para todas las carpetas. Por ejemplo, el método ParseName no se implementa para la carpeta Panel de control (CSIDL_CONTROLS). Si intenta llamar a un método no implementado, se genera un error de 0x800A01BD (decimal 445).

 

Ejemplos

En el ejemplo siguiente se usa MoveHere para mover el archivo Temp.txt desde el directorio raíz de la unidad C a la carpeta C:\Windows. Se muestra un uso adecuado para JScript, VBScript y Visual Basic.

Jscript:

<script language="JScript">
    var FOF_NOCONFIRMATION = 16;

    function fnFolderObjectMoveHereJ()
    {
        var objShell  = new ActiveXObject("shell.application");
        var objFolder = new Object;
        
        objFolder = objShell.NameSpace("C:\\WINDOWS");
        if (objFolder != null)
        {
            objFolder.MoveHere ("C:\\temp.txt", FOF_NOCONFIRMATION);
        }
    }
</script>

Vbscript:

<script language="VBScript">
    private const FOF_NOCONFIRMATION = 16
    
    function fnFolderObjectMoveHereVB()
        dim objShell
        dim objFolder

        set objShell = CreateObject("shell.application")
        set objFolder = objShell.NameSpace("C:\WINDOWS")

        if (not objFolder is nothing) then
            objFolder.MoveHere "C:\temp.txt", FOF_NOCONFIRMATION
        end if

        set objFolder = nothing
        set objShell = nothing
    end function
</script>

Visual Basic:

Private Const FOF_NOCONFIRMATION = &H10

Private Sub btnMoveHere_Click()
    Dim objShell  As Shell
    Dim objFolder As Folder

    Set objShell = New Shell
    Set objFolder = objShell.NameSpace("C:\WINDOWS")

    If (Not objFolder Is Nothing) Then
        objFolder.MoveHere "c:\temp.txt", FOF_NOCONFIRMATION
    End If

    Set objFolder = Nothing
    Set objShell = Nothing
End Sub

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional, Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado	Shldisp.h
IDL	Shldisp.idl
Archivo DLL	Shell32.dll (versión 4.71 o posterior)