Aracılığıyla paylaş


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

Tanım

İletişim kutusunda bir istem görüntüler, kullanıcının metin girmesini veya bir düğmeye tıklamasını bekler ve 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şuyorsaPrompt, her satır arasında satır başı karakteri (13)), satır besleme karakteri (Chr(Chr(10)) veya satır başı/satır besleme bileşimi (Chr(13) & Chr(10)) kullanarak satırları 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

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

Örnekler

Bu örnekte, kullanıcıdan InputBox bir değer girmesini istemesi için işlevini kullanmanın ç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 uzunlukta 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. Konumsal bağımsız değişkenleri atlarsanız, karşılık gelen virgül sınırlayıcısını korumanız gerekir.

Not

InputBox işlevi, kısmi güven durumlarında yürütülmesini etkileyebilecek düzeyde olmasını gerektirir UIPermissionSafeTopLevelWindows. Daha fazla bilgi için bkz. İstek İzinleri ve UIPermission .

Şunlara uygulanır

Ayrıca bkz.