Metode Folder.CopyHere

Menyalin item atau item ke folder.

Sintaks

Folder.CopyHere(
  vItem,
  [ vOptions ]
)

Parameter

vItem

Jenis: Varian

Item atau item yang akan disalin. Ini bisa berupa string yang mewakili nama file, objek FolderItem , atau objek FolderItems .

vOptions [opsional]

Jenis: Varian

Opsi untuk operasi salin. Nilai ini bisa nol atau kombinasi dari nilai berikut. Nilai-nilai ini didasarkan pada bendera yang ditentukan untuk digunakan dengan anggota fFlags dari struktur C++ SHFILEOPSTRUCT . Setiap namespace Shell harus menyediakan implementasinya sendiri dari bendera ini, dan setiap namespace layanan dapat memilih untuk mengabaikan beberapa atau bahkan semua bendera ini. Bendera ini tidak ditentukan berdasarkan nama untuk Visual Basic, VBScript, atau JScript, jadi Anda harus menentukannya sendiri atau menggunakan setara numeriknya.

Catatan

Dalam beberapa kasus, seperti file terkompresi (.zip), beberapa bendera opsi dapat diabaikan berdasarkan desain.

 

(4)

Jangan tampilkan kotak dialog kemajuan.

(8)

Berikan file yang sedang dioperasikan pada nama baru dalam operasi pindah, salin, atau ganti nama jika file dengan nama target sudah ada.

(16)

Tanggapi dengan "Ya untuk Semua" untuk kotak dialog apa pun yang ditampilkan.

(64)

Pertahankan informasi urungkan, jika memungkinkan.

(128)

Lakukan operasi pada file hanya jika nama file kartubebas (*.*) ditentukan.

(256)

Tampilkan kotak dialog kemajuan tetapi tidak memperlihatkan nama file.

(512)

Jangan mengonfirmasi pembuatan direktori baru jika operasi mengharuskan untuk dibuat.

(1024)

Jangan tampilkan antarmuka pengguna jika terjadi kesalahan.

(2048)

Versi 4.71. Jangan salin atribut keamanan file.

(4096)

Hanya beroperasi di direktori lokal. Jangan beroperasi secara rekursif ke subdirektori.

(8192)

Versi 5.0. Jangan salin file yang tersambung sebagai grup. Hanya salin file yang ditentukan.

Nilai kembali

Metode ini tidak mengembalikan nilai.

Keterangan

Tidak ada pemberitahuan yang diberikan kepada program panggilan untuk menunjukkan bahwa salinan telah selesai.

Catatan

Tidak semua metode diimplementasikan untuk semua folder. Misalnya, metode ParseName tidak diimplementasikan untuk folder Panel Kontrol (CSIDL_CONTROLS). Jika Anda mencoba memanggil metode yang tidak terimlementasi, kesalahan 0x800A01BD (desimal 445) dimunculkan.

 

Contoh

Contoh berikut menggunakan CopyHere untuk menyalin file Autoexec.bat dari direktori akar ke direktori C:\Windows. Penggunaan yang tepat ditampilkan untuk JScript, VBScript, dan Visual Basic.

Jscript:

<script language="JScript">
    function fnCopyHereJ()
    {
        var objShell = new ActiveXObject("shell.application");
        var objFolder = new Object;
        
        objFolder = objShell.NameSpace("C:\\WINDOWS");
        if (objFolder != null)
        {
            objFolder.CopyHere("C:\\AUTOEXEC.BAT");
        }
    }
 </script>

Vbscript:

<script language="VBScript">
    function fnCopyHereVB()
        dim objShell
        dim objFolder
        
        set objShell = CreateObject("shell.application")
        set objFolder = objShell.NameSpace("C:\WINDOWS")
 
        if not objFolder is nothing then
            objFolder.CopyHere("C:\AUTOEXEC.BAT")
        end if
 
        set objShell = nothing
        set objFolder = nothing
    end function
</script>

Visual Basic:

Private Sub btnCopyHere_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.CopyHere ("C:\AUTOEXEC.BAT")
    End If
 
    Set objFolder = Nothing
    Set objShell = Nothing
End Sub

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional, Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Header	Shldisp.h
IDL	Shldisp.idl
DLL	Shell32.dll (versi 4.71 atau yang lebih baru)

Lihat juga

Folder