Interaction.InputBox(String, String, String, Int32, Int32) Yöntem
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
İ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 UIPermission
SafeTopLevelWindows. Daha fazla bilgi için bkz. İstek İzinleri ve UIPermission .