Metode IShellDispatch2.ShellExecute

Melakukan operasi tertentu pada file tertentu.

Sintaks

iRetVal = IShellDispatch2.ShellExecute(
  sFile,
  [ vArguments ],
  [ vDirectory ],
  [ vOperation ],
  [ vShow ]
)

IShellDispatch2.ShellExecute( _
  ByVal sFile As BSTR, _
  [ ByVal vArguments As Variant ], _
  [ ByVal vDirectory As Variant ], _
  [ ByVal vOperation As Variant ], _
  [ ByVal vShow As Variant ] _
) As Integer

Parameter

sFile [in]

Jenis: BSTR

String yang berisi nama file tempat ShellExecute akan melakukan tindakan yang ditentukan oleh vOperation.

vArguments [in, opsional]

Jenis: Varian

String yang berisi nilai parameter untuk operasi.

vDirectory [in, opsional]

Jenis: Varian

Jalur direktori yang sepenuhnya memenuhi syarat yang berisi file yang ditentukan oleh sFile. Jika parameter ini tidak ditentukan, direktori kerja saat ini digunakan.

vOperation [in, opsional]

Jenis: Varian

Operasi yang akan dilakukan. Nilai ini diatur ke salah satu string kata kerja yang didukung oleh file. Untuk diskusi kata kerja, lihat bagian Keterangan. Jika parameter ini tidak ditentukan, operasi default dilakukan.

vShow [in, opsional]

Jenis: Varian

Rekomendasi tentang bagaimana jendela aplikasi harus ditampilkan pada awalnya. Aplikasi dapat mengabaikan rekomendasi ini. Parameter ini bisa menjadi salah satu nilai berikut. Jika parameter ini tidak ditentukan, aplikasi menggunakan nilai defaultnya.

Nilai	Makna
0	Buka aplikasi dengan jendela tersembunyi.
1	Buka aplikasi dengan jendela normal. Jika jendela diminimalkan atau dimaksimalkan, sistem memulihkannya ke ukuran dan posisi aslinya.
2	Buka aplikasi dengan jendela yang diminimalkan.
3	Buka aplikasi dengan jendela yang dimaksimalkan.
4	Buka aplikasi dengan jendelanya pada ukuran dan posisi terbarunya. Jendela aktif tetap aktif.
5	Buka aplikasi dengan jendelanya pada ukuran dan posisinya saat ini.
7	Buka aplikasi dengan jendela yang diminimalkan. Jendela aktif tetap aktif.
10	Buka aplikasi dengan jendelanya dalam status default yang ditentukan oleh aplikasi.

 

Keterangan

Metode ini diimplementasikan dan diakses melalui metode Shell.ShellExecute .

Metode ini setara dengan meluncurkan salah satu perintah yang terkait dengan menu pintasan file. Setiap perintah diwakili oleh string kata kerja. Kumpulan kata kerja yang didukung bervariasi dari file ke file. Kata kerja yang paling umum didukung adalah "terbuka", yang juga biasanya kata kerja default. Kata kerja lain mungkin hanya didukung oleh jenis file tertentu. Untuk diskusi lebih lanjut tentang kata kerja Shell, lihat Meluncurkan Aplikasi atau Memperluas Menu Pintasan.

Metode ini saat ini tidak tersedia di Microsoft Visual Basic.

Contoh

Contoh berikut menunjukkan penggunaan ShellExecute untuk membuka Notepad. Penggunaan ditampilkan untuk JScript dan VBScript.

Jscript:

<script language="JScript">
    function fnShellExecuteJ()
    {
        var objShell = new ActiveXObject("shell.application");
        
        objShell.ShellExecute("notepad.exe", "", "", "open", 1);
    }
</script>

Vbscript:

<script language="VBScript">
    function fnShellExecuteVB()
        dim objShell

        set objShell = CreateObject("shell.application")

        objShell.ShellExecute "notepad.exe", "", "", "open", 1

        set objShell = nothing
    end function
</script>

Persyaratan

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