Menampilkan perintah dalam kotak dialog, menunggu pengguna memasukkan teks atau mengklik tombol, dan mengembalikan String yang berisi konten kotak teks.
Sintaks
InputBox(prompt [, judul ] [, default ] [, xpos ] [, ypos ] [, helpfile ] [, konteks ] ] )
Sintaks fungsi InputBox memiliki argumen berikut:
| Argumen | Deskripsi |
|---|---|
| perintah | Diperlukan. Ekspresi string ditampilkan sebagai pesan dalam kotak dialog. Panjang maksimum perintah adalah sekitar 1024 karakter, tergantung pada lebar karakter yang digunakan. Jika perintah terdiri dari lebih dari satu baris, Anda dapat memisahkan baris menggunakan karakter carriage return (Chr(13)), karakter linefeed (Chr(10)), atau kombinasi karakter carriage return–linefeed (Chr(13) & Chr(10)) di antara setiap baris. |
| judul | Opsional. Ekspresi string ditampilkan di bilah judul kotak dialog. Jika Anda menghilangkan judul, nama aplikasi akan ditempatkan di bilah judul. |
| default | Opsional. Ekspresi string ditampilkan di kotak teks sebagai respons default jika tidak ada input lain yang disediakan. Jika Anda menghilangkan default, kotak teks akan ditampilkan kosong. |
| XPOS | Opsional. Ekspresi numerik yang menentukan, dalam twips, jarak horizontal tepi kiri kotak dialog dari tepi kiri layar. Jika xpos jenis dikosongkan, kotak dialog akan berada di tengah horizontal. |
| YPOS | Opsional. Ekspresi numerik yang menentukan, dalam twips, jarak vertikal tepi atas kotak dialog dari bagian atas layar. Jika ypos dikosongkan, kotak dialog diposisikan secara vertikal kira-kira sepertiga dari jalan ke bawah layar. |
| file bantuan | Opsional. Ekspresi string yang mengidentifikasi file Bantuan yang akan digunakan untuk menyediakan Bantuan peka konteks untuk kotak dialog. Jika file bantuan disediakan, konteks juga harus disediakan. |
| Konteks | Opsional. Ekspresi numerik yang merupakan nomor konteks Bantuan yang ditetapkan untuk topik Bantuan yang sesuai oleh penulis Bantuan. Jika konteks disediakan, helpfile juga harus disediakan. |
Keterangan
Ketika file bantuan dan konteks disediakan, pengguna dapat menekan F1 (Windows) atau HELP (Macintosh) untuk menampilkan topik Bantuan yang sesuai dengan konteks. Beberapa aplikasi host juga secara otomatis menambahkan tombol Bantuan ke kotak dialog. Jika pengguna mengklik OK atau menekan ENTER, fungsi InputBox mengembalikan apa pun yang ada dalam kotak teks. Jika pengguna mengklik Batal, fungsi akan mengembalikan string kosong ("").
Catatan
Untuk menentukan lebih dari argumen yang disebutkan sebelumnya, Anda harus menggunakan InputBox dalam sebuah ekspresi. Untuk menghilangkan beberapa argumen posisi, Anda harus menyertakan pemisah koma yang sesuai.
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 menunjukkan berbagai cara untuk menggunakan fungsi InputBox untuk meminta pengguna memasukkan nilai. Jika posisi x dan y dikosongkan, kotak dialog secara otomatis dipusatkan untuk masing-masing sumbu. Variabel MyValue berisi nilai yang dimasukkan oleh pengguna jika pengguna mengklik OK atau menekan tombol ENTER. Jika pengguna mengklik Batal, string kosong akan dikembalikan.
Dim Message, Title, Default, MyValue
Message = "Enter a value between 1 and 3" ' Set prompt.
Title = "InputBox Demo" ' Set title.
Default = "1" ' Set default.
' Display message, title, and default value.
MyValue = InputBox(Message, Title, Default)
' Use Helpfile and context.
' The Help button is added automatically.
MyValue = InputBox(Message, Title,,,,"DEMO.HLP", 10)
' Display dialog box at position 100, 100.
MyValue = InputBox(Message, Title, Default, 100, 100)