İletişim kutusunda bir istem görüntüler, kullanıcının metin girişini bekler veya bir düğmeye tıklar ve metin kutusunun içeriğini içeren bir Dize döndürür.
Söz dizimi
InputBox ( prompt [, title ] [, default ] [, xpos ] [, ypos ] [, helpfile ] [, context ] )
InputBox işlevinin söz diziminde şu bağımsız değişkenler bulunur:
|
Bağımsız değişken |
Açıklama |
|
Istemi |
Gerekli. İletişim kutusunda ileti olarak görüntülenen dize ifadesi. Kullanılan karakterlerin genişliğine bağlı olarak , en fazla istem uzunluğu yaklaşık 1024 karakterdir. İstem birden çok satırdan oluşuyorsa, satırları her satır arasında satır başı karakteri (Chr(13)), satır besleme karakteri (Chr(10)) veya satır başı-satır besleme karakter bileşimi (Chr(13) & Chr(10)) kullanarak ayırabilirsiniz. |
|
Başlık |
İsteğe bağlı. İletişim kutusunun başlık çubuğunda görüntülenen dize ifadesi. Başlığı atlarsanız, uygulama adı başlık çubuğuna yerleştirilir. |
|
varsayılan |
İsteğe bağlı. Başka bir giriş sağlanmazsa metin kutusunda varsayılan yanıt olarak görüntülenen dize ifadesi. Varsayılan değeri atlarsanız, metin kutusu boş görüntülenir. |
|
xpos |
İsteğe bağlı. Twips içinde iletişim kutusunun sol kenarından ekranın sol kenarından yatay uzaklığı belirten sayısal ifade. Xpos belirtilmezse, iletişim kutusu yatay olarak ortalanır. |
|
ypos |
İsteğe bağlı. Twips içinde, iletişim kutusunun üst kenarının ekranın üst kısmından dikey uzaklığı belirten sayısal ifade. ypos belirtilmezse, iletişim kutusu ekranın aşağı doğru yaklaşık üçte biri dikey olarak konumlandırılır. |
|
Helpfile |
İsteğe bağlı. İletişim kutusu için bağlama duyarlı Yardım sağlamak için kullanılacak Yardım dosyasını tanımlayan dize ifadesi. Yardım dosyası sağlanmışsa bağlam da sağlanmalıdır. |
|
Bağlam |
İsteğe bağlı. Yardım yazarı tarafından uygun Yardım konusuna atanan Yardım bağlam numarası olan sayısal ifade. Bağlam sağlanmışsa, yardım dosyası da sağlanmalıdır. |
Notlar
Hem yardım dosyası hem de bağlam sağlandığında, kullanıcı bağlama karşılık gelen Yardım konusunu görüntülemek için F1 (Windows) veya HELP (Macintosh) tuşlarına basabilir. Bazı ana bilgisayar uygulaması ( örneğin, Microsoft Office Excel 2007 ) iletişim kutusuna otomatik olarak bir Yardım düğmesi ekler. Kullanıcı Tamam'a tıklarsa veya ENTER tuşuna basarsa , InputBox işlevi metin kutusundaki her şeyi döndürür. Kullanıcı İptal'e tıklarsa işlev sıfır uzunluklu bir dize ("") döndürür.
Not: İlk adlandırılmış bağımsız değişkenden daha fazlasını belirtmek için bir ifadeInputBox kullanmanız gerekir. Bazı konumsal bağımsız değişkenleri atlarsanız, karşılık gelen virgül sınırlayıcısını eklemeniz gerekir.
Örnek
Not: Aşağıdaki örneklerde, bu işlevin Visual Basic for Applications (VBA) modülünde kullanımı gösterilir. VBA ile çalışma hakkında daha fazla bilgi için, rama'nın yanındaki açılan listede Geliştirici Başvurusu'nu seçin ve arama kutusuna bir veya birden çok terim yazın.
Bu örnekte, kullanıcıdan bir değer girmesini istemesi için InputBox işlevini kullanmanın çeşitli yolları gösterilmektedir. X ve y konumları atlanırsa, iletişim kutusu otomatik olarak ilgili eksenler için ortalanır. MyValue değişkeni, kullanıcı Tamam'a tıklarsa veya ENTER tuşuna basarsa kullanıcı tarafından girilen değeri içerir. Kullanıcı İptal'e tıklarsa sıfır uzunluklu bir dize döndürülür.
Dim Message, Title, Default, MyValue
Message = "Enter a value between 1 and 3" ' Set prompt.
Title = "InputBox Demo" ' Set title.
Default = "1" ' Set default.
' Display message, title, and default value.
MyValue = InputBox(Message, Title, Default)
' Use Helpfile and context.
' The Help button is added automatically.
MyValue = InputBox(Message, Title,,,,"DEMO.HLP", 10)
' Display dialog box at position 100, 100.
MyValue = InputBox(Message, Title, Default, 100, 100)
