Interaction.InputBox(String, String, String, Int32, Int32) Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Menampilkan perintah dalam kotak dialog, menunggu pengguna memasukkan teks atau mengklik tombol, lalu mengembalikan string yang berisi konten kotak teks.
public static string InputBox (string Prompt, string Title = "", string DefaultResponse = "", int XPos = -1, int YPos = -1);
static member InputBox : string * string * string * int * int -> string
Public Function InputBox (Prompt As String, Optional Title As String = "", Optional DefaultResponse As String = "", Optional XPos As Integer = -1, Optional YPos As Integer = -1) As String
Parameter
- Prompt
- String
Ekspresi yang diperlukan String
ditampilkan sebagai pesan dalam kotak dialog. Panjang Prompt
maksimum adalah sekitar 1024 karakter, tergantung pada lebar karakter yang digunakan. Jika Prompt
terdiri dari lebih dari satu baris, Anda dapat memisahkan garis menggunakan karakter pengembalian pengangkutan (Chr(
13)
), karakter umpan garis (Chr(
10)
), atau kombinasi umpan kembali/garis pengangkutan (Chr(
13)
& Chr(
10)
) di antara setiap baris.
- Title
- String
Pilihan.
String
ekspresi ditampilkan di bilah judul kotak dialog. Jika Anda menghilangkan Title
, nama aplikasi ditempatkan di bilah judul.
- DefaultResponse
- String
Pilihan.
String
ekspresi ditampilkan dalam kotak teks sebagai respons default jika tidak ada input lain yang disediakan. Jika Anda menghilangkan DefaultResponse
, kotak teks yang ditampilkan kosong.
- XPos
- Int32
Pilihan. Ekspresi numerik yang menentukan, dalam twips, jarak tepi kiri kotak dialog dari tepi kiri layar. Jika Anda menghilangkan XPos
, kotak dialog dipusatkan secara horizontal.
- YPos
- Int32
Pilihan. Ekspresi numerik yang menentukan, dalam ranting, jarak tepi atas kotak dialog dari bagian atas layar. Jika Anda menghilangkan YPos
, kotak dialog diposisikan secara vertikal sekitar sepertiga dari jalan ke bawah layar.
Mengembalikan
Menampilkan perintah dalam kotak dialog, menunggu pengguna memasukkan teks atau mengklik tombol, lalu mengembalikan string yang berisi konten kotak teks.
Contoh
Contoh ini menunjukkan berbagai cara untuk menggunakan InputBox
fungsi untuk meminta pengguna memasukkan nilai. Jika posisi x dan y dihilangkan, kotak dialog secara otomatis dipusatkan untuk sumbu masing-masing. Variabel MyValue
berisi nilai yang dimasukkan oleh pengguna jika pengguna mengklik OK atau menekan tombol ENTER.
Dim message, title, defaultValue As String
Dim myValue As Object
' Set prompt.
message = "Enter a value between 1 and 3"
' Set title.
title = "InputBox Demo"
defaultValue = "1" ' Set default value.
' Display message, title, and default value.
myValue = InputBox(message, title, defaultValue)
' If user has clicked Cancel, set myValue to defaultValue
If myValue Is "" Then myValue = defaultValue
' Display dialog box at position 100, 100.
myValue = InputBox(message, title, defaultValue, 100, 100)
' If user has clicked Cancel, set myValue to defaultValue
If myValue Is "" Then myValue = defaultValue
Keterangan
Jika pengguna mengklik Batal, string panjang nol akan dikembalikan.
Untuk menentukan lebih dari argumen pertama, Anda harus menggunakan InputBox
fungsi dalam ekspresi. Jika Anda menghilangkan argumen posisi, Anda harus mempertahankan pemisah koma yang sesuai.
Catatan
Fungsi ini InputBox
membutuhkan UIPermission
pada SafeTopLevelWindows tingkat , yang dapat memengaruhi eksekusinya dalam situasi kepercayaan parsial. Untuk informasi selengkapnya, lihat Meminta Izin dan UIPermission .