Catatan
Fungsi, metode, objek, atau properti yang dijelaskan dalam topik ini dinonaktifkan jika Layanan Ekspresi Microsoft Jet berjalan dalam mode kotak pasir, yang mencegah evaluasi ekspresi yang berpotensi tidak aman. Untuk informasi selengkapnya tentang mode kotak pasir, cari "mode kotak pasir" di Bantuan.
Menjalankan program yang dapat dieksekusi dan mengembalikan Varian (Ganda) yang mewakili ID tugas program jika berhasil, jika tidak, akan mengembalikan nol.
Sintaks
Shell(nama jalur [, gaya jendela ] )
Sintaks fungsi Shell memiliki argumen berikut:
| Argumen | Deskripsi |
|---|---|
| nama jalur | Diperlukan.
varian (string). Nama program yang akan dijalankan dan argumen atau sakelar baris perintah yang diperlukan; Dapat mencakup direktori atau folder dan drive. Di Macintosh, Anda dapat menggunakan fungsi MacID untuk menentukan tanda tangan aplikasi, bukan namanya. Contoh berikut menggunakan tanda tangan untuk Microsoft Word:Shell MacID("MSWD") |
| gaya jendela | Opsional. Varian (Bilangan bulat) yang sesuai dengan gaya jendela di mana program akan dijalankan. Jika gaya jendela dikosongkan, program dimulai dengan diminimalkan dengan fokus. Di Macintosh (Sistem 7.0 atau yang lebih baru), gaya jendela hanya menentukan apakah aplikasi mendapatkan fokus atau tidak saat dijalankan. |
Argumen bernama gaya jendela memiliki nilai berikut:
| Konstanta | Value | Deskripsi |
|---|---|---|
| vbHide | 0 | Jendela disembunyikan dan fokus diteruskan ke jendela tersembunyi. Konstanta vbHide tidak berlaku di platform Macintosh. |
| vbNormalFocus | 1 | Jendela memiliki fokus dan dikembalikan ke ukuran dan posisi aslinya. |
| vbMinimizedFocus | 2 | Jendela ditampilkan sebagai ikon dengan fokus. |
| vbMaximizedFocus | 3 | Jendela dimaksimalkan dengan fokus. |
| vbNormalNoFocus | 4 | Jendela dikembalikan ke ukuran dan posisi terbarunya. Jendela aktif saat ini tetap aktif. |
| vbMinimizedNoFocus | 6 | Jendela ditampilkan sebagai ikon. Jendela aktif saat ini tetap aktif. |
Keterangan
Jika fungsi Shell berhasil menjalankan file yang bernama, fungsi akan mengembalikan ID tugas dari program yang dimulai. ID tugas adalah nomor unik yang mengidentifikasi program yang sedang berjalan. Jika fungsi Shell tidak dapat memulai program yang disebutkan, kesalahan akan terjadi.
Di Macintosh, vbNormalFocus, vbMinimizedFocus, dan vbMaximizedFocus semuanya menempatkan aplikasi di latar depan; vbHide, vbNoFocus, vbMinimizeFocus semuanya menempatkan aplikasi di latar belakang.
Catatan
Secara default, fungsi Shell menjalankan program lain secara asinkron. Ini berarti bahwa program yang dimulai dengan Shell mungkin tidak selesai dieksekusi sebelum pernyataan setelah fungsi Shell dijalankan.
Contoh
Catatan
Contoh yang mengikuti demonstrasi penggunaan fungsi ini dalam modul Visual Basic for Applications (VBA). Untuk informasi selengkapnya tentang bekerja dengan VBA, pilih Referensi Pengembang di daftar turun bawah di samping Cari dan masukkan satu istilah atau lebih di kotak pencarian.
Contoh ini menggunakan fungsi Shell untuk menjalankan aplikasi yang ditentukan oleh pengguna. Di MacIntosh, nama drive default adalah "HD" dan bagian dari nama jalur dipisahkan oleh titik dua, bukan garis miring terbalik. Demikian pula, Anda akan menentukan folder Macintosh, bukan \Windows.
' Specifying 1 as the second argument
' opens the application in normal size and
' gives it the focus.
Dim RetVal
' Run Calculator.
RetVal = Shell("C:\WINDOWS\CALC.EXE", 1)