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 版。 請勿將連線的檔案移動為群組。 只移動指定的檔案。

傳回值

這個方法不會傳回值。

備註

注意

並非所有方法都會針對所有資料夾實作。 例如,不會針對主控台資料夾實作ParseName方法 (CSIDL_CONTROLS) 。 如果您嘗試呼叫未實作的方法,就會引發0x800A01BD (十進位 445) 錯誤。

 

範例

下列範例會使用 MoveHere 將檔案從 C 磁片磁碟機的根目錄移至 C:\Windows 資料夾Temp.txt。 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 Professional、Windows XP [僅限桌面應用程式]
最低支援的伺服器
Windows 2000 Server [僅限桌面應用程式]
標頭
Shldisp.h
Idl
Shldisp.idl
DLL
Shell32.dll (4.71 版或更新版本)