Méthode Folder.MoveHere

Article
06/13/2023

Déplace un ou plusieurs éléments vers ce dossier.

Syntaxe

Folder.MoveHere(
  vItem,
  [ vOptions ]
)

Paramètres

vItem [in]

Type : Variant

Élément ou éléments à déplacer. Il peut s’agir d’une chaîne qui représente un nom de fichier, un objet FolderItem ou un objet FolderItems .

vOptions [in, facultatif]

Type : Variant

Options pour l’opération de déplacement. Cette valeur peut être zéro ou une combinaison des valeurs suivantes. Ces valeurs sont basées sur des indicateurs définis pour une utilisation avec le membre fFlags de la structure C++ SHFILEOPSTRUCT . Ces indicateurs ne sont pas définis comme tels pour Visual Basic, VBScript ou JScript. Vous devez donc les définir vous-même ou utiliser leurs équivalents numériques.

(4)

N’affichez pas de boîte de dialogue de progression.

(8)

Donnez au fichier en cours d’exploitation un nouveau nom dans une opération de déplacement, de copie ou de renommage si un fichier portant le nom cible existe déjà.

(16)

Répondez avec « Oui à tous » pour toute boîte de dialogue qui s’affiche.

(64)

Conservez les informations d’annulation, si possible.

(128)

Effectuez l’opération sur les fichiers uniquement si un nom de fichier générique (*.*) est spécifié.

(256)

Affichez une boîte de dialogue de progression, mais n’affichez pas les noms de fichiers.

(512)

Ne confirmez pas la création d’un répertoire si l’opération en nécessite la création.

(1024)

N’affichez pas d’interface utilisateur si une erreur se produit.

(2048)

Version 4.71. Ne copiez pas les attributs de sécurité du fichier.

(4096)

Fonctionnent uniquement dans le répertoire local. N’effectuez pas d’opérations récursives dans les sous-répertoires.

(9182)

Version 5.0. Ne déplacez pas les fichiers connectés en tant que groupe. Déplacez uniquement les fichiers spécifiés.

Valeur retournée

Cette méthode ne retourne pas de valeur.

Notes

Toutes les méthodes ne sont pas implémentées pour tous les dossiers. Par exemple, la méthode ParseName n’est pas implémentée pour le dossier Panneau de configuration (CSIDL_CONTROLS). Si vous tentez d’appeler une méthode non implémentée, une erreur 0x800A01BD (décimale 445) est générée.

Exemples

L’exemple suivant utilise MoveHere pour déplacer le fichier Temp.txt du répertoire racine du lecteur C vers le dossier C:\Windows. Une utilisation correcte est indiquée pour JScript, VBScript et 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

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel, Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
En-tête	Shldisp.h
IDL	Shldisp.idl
DLL	Shell32.dll (version 4.71 ou ultérieure)

Partager via