Interaction.InputBox(String, String, String, Int32, Int32) Yöntem

Tanım

Ad Alanı:

Microsoft.VisualBasic

Bütünleştirilmiş Kod:

Microsoft.VisualBasic.Core.dll

Kaynak:

Interaction.vb

İletişim kutusunda bir istem görüntüler, kullanıcının metin girişini bekler veya bir düğmeye tıklar ve ardından metin kutusunun içeriğini içeren bir dize döndürür.

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

Parametreler

Prompt

String

gerekli String ifade, iletişim kutusunda ileti olarak görüntülenir. Kullanılan karakterlerin Prompt genişliğine bağlı olarak uzunluk üst sınırı yaklaşık 1024 karakterdir. Birden fazla satırdan oluşuyorsa Prompt , satırları her satır arasında bir satır başı karakteri (Chr(13)), satır besleme karakteri (Chr(10)) veya satır başı/satır besleme bileşimi (Chr(13) & Chr(10)) kullanarak ayırabilirsiniz.

Title

String

İsteğe bağlı. String ifadesi iletişim kutusunun başlık çubuğunda görüntülenir. değerini atlarsanız Title, uygulama adı başlık çubuğuna yerleştirilir.

DefaultResponse

String

İsteğe bağlı. String ifadesi, başka bir giriş sağlanmazsa metin kutusunda varsayılan yanıt olarak görüntülenir. atlarsanız DefaultResponse, görüntülenen metin kutusu boş olur.

XPos

Int32

İsteğe bağlı. Twips içinde iletişim kutusunun sol kenarının ekranın sol kenarından uzaklığı belirten sayısal ifade. atlarsanız XPos, iletişim kutusu yatay olarak ortalanır.

YPos

Int32

İsteğe bağlı. Twips içinde, iletişim kutusunun üst kenarının ekranın en üstünden uzaklığı belirten sayısal ifade. atlarsanız YPos, iletişim kutusu ekranın aşağı doğru yaklaşık üçte biri dikey olarak konumlandırılır.

Döndürülenler

String

İletişim kutusunda bir istem görüntüler, kullanıcının metin girişini bekler veya bir düğmeye tıklar ve ardından metin kutusunun içeriğini içeren bir dize döndürür.

Örnekler

Bu örnekte, kullanıcıdan bir değer girmesini isteyen işlevini kullanmanın InputBox çeşitli yolları gösterilmektedir. X ve y konumları atlanırsa, iletişim kutusu ilgili eksenler için otomatik olarak ortalanır. Değişken MyValue , kullanıcı Tamam'a tıklarsa veya ENTER tuşuna basarsa kullanıcı tarafından girilen değeri içerir.

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

Açıklamalar

Kullanıcı İptal'e tıklarsa sıfır uzunluklu bir dize döndürülür.

İlk bağımsız değişkenden daha fazlasını belirtmek için işlevini bir ifadede kullanmanız InputBox gerekir. Herhangi bir konumsal bağımsız değişkeni atlarsanız, karşılık gelen virgül sınırlayıcısını korumanız gerekir.

Not

İşlev InputBox , kısmi güven durumlarında yürütülmesini etkileyebilecek düzeyde gerektirir UIPermissionSafeTopLevelWindows . Daha fazla bilgi için bkz. İzin İsteme ve UIPermission .

Ayrıca bkz.

• MsgBox(Object, MsgBoxStyle, Object)
• Chr(Int32)
• ChrW(Int32)