Menampilkan perintah dalam kotak dialog, menunggu pengguna untuk memasukkan teks atau mengklik tombol, dan mengembalikan String yang berisi konten kotak teks.
Sintaks
InputBox ( prompt [, title ] [, default ] [, xpos ] [, ypos ] [, helpfile ] [, context ] )
Sintaks fungsi InputBox memiliki argumen ini:
|
Argumen |
Deskripsi |
|
Prompt |
Diperlukan. Ekspresi string ditampilkan sebagai pesan dalam kotak dialog. Panjang maksimum prompt adalah sekitar 1024 karakter, tergantung pada lebar karakter yang digunakan. Jika prompt terdiri dari lebih dari satu baris, Anda dapat memisahkan garis menggunakan karakter kembali (Chr(13)), karakter linefeed (Chr(10)), atau kombinasi karakter return-linefeed carriage (Chr(13) & Chr(10)) di antara setiap baris. |
|
Judul |
Opsional. Ekspresi string ditampilkan di bilah judul kotak dialog. Jika Anda menghilangkan judul, nama aplikasi ditempatkan di bilah judul. |
|
default |
Opsional. Ekspresi string ditampilkan dalam kotak teks sebagai respons default jika tidak ada input lain yang disediakan. Jika Anda menghilangkan default, kotak teks ditampilkan kosong. |
|
xpos |
Opsional. Ekspresi numerik yang menentukan, dalam twips, jarak horizontal tepi kiri kotak dialog dari tepi kiri layar. Jika xpos dihilangkan, kotak dialog ditengahkan secara horizontal. |
|
ypos |
Opsional. Ekspresi numerik yang menentukan, dalam twips, jarak vertikal tepi atas kotak dialog dari bagian atas layar. Jika ypos dihilangkan, kotak dialog ditempatkan secara vertikal sekitar sepertiga dari arah bawah layar. |
|
helpfile |
Opsional. Ekspresi string yang mengidentifikasi file Bantuan untuk digunakan guna menyediakan Bantuan peka konteks untuk kotak dialog. Jika helpfile disediakan, konteks juga harus disediakan. |
|
Konteks |
Opsional. Ekspresi numerik yang merupakan nomor konteks Bantuan yang ditetapkan ke topik Bantuan yang sesuai oleh penulis Bantuan. Jika konteks disediakan, helpfile juga harus disediakan. |
Keterangan
Ketika bantuan dankonteks disediakan, pengguna dapat menekan F1 (Windows) atau HELP (Macintosh) untuk menampilkan topik Bantuan yang sesuai dengan konteks. Beberapa aplikasi host, misalnya, Microsoft Office Excel 2007, 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 mengembalikan string panjang-nol ("").
Catatan: Untuk menentukan lebih dari argumen bernama pertama, Anda harus menggunakan InputBox dalam ekspresi. Untuk menghilangkan beberapa argumen posisi, Anda harus menyertakan pemisah koma terkait.
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 memperlihatkan berbagai cara untuk menggunakan fungsi InputBox untuk meminta pengguna memasukkan nilai. Jika posisi x dan y dihilangkan, kotak dialog secara otomatis ditengahkan 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 panjang-nol 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)
