Folder.MoveHere 方法

将一个或多个项目移动到此文件夹。

语法

Folder.MoveHere(
  vItem,
  [ vOptions ]
)

参数

vItem [in]

类型: Variant

要移动的一个或多个项。 这可以是表示文件名的字符串、 FolderItem 对象或 FolderItems 对象。

vOptions [in, optional]

类型: Variant

移动操作的选项。 此值可以是零,也可以是以下值的组合。 这些值基于为与 C++ SHFILEOPSTRUCT 结构的 fFlags 成员一起使用而定义的标志。 这些标志不是针对 Visual Basic、VBScript 或 JScript 定义的,因此你必须自行定义它们或使用其数值等效项。

(4)

不显示进度对话框。

(8)

如果已存在具有目标名称的文件,请在移动、复制或重命名操作中为正在操作的文件提供新名称。

(16)

对于显示的任何对话框,响应为“全部是”。

(64)

如果可能,请保留撤消信息。

(128)

仅当指定通配符文件名 (*.*) 时,才对文件执行操作。

(256)

显示进度对话框,但不显示文件名。

(512)

如果操作需要创建新目录,请不要确认创建新目录。

(1024)

如果发生错误,则不显示用户界面。

(2048)

版本 4.71。 请勿复制文件的安全属性。

(4096)

仅在本地目录中操作。 不要以递归方式操作到子目录中。

(9182)

版本 5.0。 不要将连接的文件作为一个组移动。 仅移动指定的文件。

返回值

此方法不返回值。

备注

注意

并非所有方法都是针对所有文件夹实现的。 例如,没有为 控制面板 文件夹 (CSIDL_CONTROLS) 实现 ParseName 方法。 如果尝试调用未实现的方法,则会引发0x800A01BD (十进制 445) 错误。

 

示例

以下示例使用 MoveHere 将文件Temp.txt从 C 驱动器的根目录移动到 C:\Windows 文件夹。 显示 JScript、VBScript 和 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

要求

要求
最低受支持的客户端
Windows 2000 专业版、Windows XP [仅限桌面应用]
最低受支持的服务器
Windows 2000 Server [仅限桌面应用]
标头
Shldisp.h
IDL
Shldisp.idl
DLL
Shell32.dll (4.71 或更高版本)