Folder.MoveHere-Methode

Verschiebt ein Element oder Elemente in diesen Ordner.

Syntax

Folder.MoveHere(
  vItem,
  [ vOptions ]
)

Parameter

vItem [in]

Typ: Variant

Das zu verschiebende Element. Dies kann eine Zeichenfolge sein, die einen Dateinamen, ein FolderItem-Objekt oder ein FolderItems-Objekt darstellt.

vOptions [in, optional]

Typ: Variant

Optionen für den Verschiebungsvorgang. Dieser Wert kann null oder eine Kombination der folgenden Werte sein. Diese Werte basieren auf Flags, die für die Verwendung mit dem fFlags-Member der C++- SHFILEOPSTRUCT-Struktur definiert sind. Diese Flags sind nicht als solche für Visual Basic, VBScript oder JScript definiert, daher müssen Sie sie selbst definieren oder ihre numerischen Entsprechungen verwenden.

(4)

Zeigt kein Statusdialogfeld an.

(8)

Geben Sie der Datei, die mit einem neuen Namen in einem Vorgang zum Verschieben, Kopieren oder Umbenennen ausgeführt wird, wenn bereits eine Datei mit dem Zielnamen vorhanden ist.

(16)

Antworten Sie mit "Ja zu allen" für jedes angezeigte Dialogfeld.

(64)

Behalten Sie nach Möglichkeit Informationen zum Rückgängigmachen bei.

(128)

Führen Sie den Vorgang nur für Dateien aus, wenn ein Platzhalterdateiname (*.*) angegeben ist.

(256)

Zeigen Sie ein Statusdialogfeld an, aber nicht die Dateinamen.

(512)

Bestätigen Sie die Erstellung eines neuen Verzeichnisses nicht, wenn für den Vorgang ein Verzeichnis erstellt werden muss.

(1024)

Zeigen Sie keine Benutzeroberfläche an, wenn ein Fehler auftritt.

(2048)

Version 4.71. Kopieren Sie die Sicherheitsattribute der Datei nicht.

(4096)

Nur im lokalen Verzeichnis ausgeführt werden. Arbeiten Sie nicht rekursiv in Unterverzeichnissen.

(9182)

Version 5.0. Verschieben Sie verbundene Dateien nicht als Gruppe. Verschieben Sie nur die angegebenen Dateien.

Rückgabewert

Diese Methode gibt keinen Wert zurück.

Bemerkungen

Hinweis

Nicht alle Methoden werden für alle Ordner implementiert. Beispielsweise wird die ParseName-Methode nicht für den ordner Systemsteuerung (CSIDL_CONTROLS) implementiert. Wenn Sie versuchen, eine nicht implementierte Methode aufzurufen, wird ein 0x800A01BD -Fehler (dezimal 445) ausgelöst.

 

Beispiele

Im folgenden Beispiel wird MoveHere verwendet, um die Datei Temp.txt aus dem Stammverzeichnis des Laufwerks C in den Ordner C:\Windows zu verschieben. Die ordnungsgemäße Verwendung wird für JScript, VBScript und Visual Basic angezeigt.

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

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional, Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Header	Shldisp.h
IDL	Shldisp.idl
DLL	Shell32.dll (Version 4.71 oder höher)