Bagikan melalui


Interaction.InputBox(String, String, String, Int32, Int32) Metode

Definisi

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 baris (Chr(10)), atau kombinasi umpan kembali/baris 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 twips, 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 .

Berlaku untuk

Lihat juga