İletişim kutusunda bir bilgi istemi görüntüler, kullanıcının metni girmesini veya bir düğmeye tıklamasını bekler ve metin kutusunun içeriğini içeren bir Dize döndürür.
Söz dizimi
InputBox(istem [, başlık ] [, varsayılan ] [, xpos ] [, ypos ] [, yardım dosyası ] [, bağlam ] )
InputBox işlevinin söz diziminde aşağıdaki bağımsız değişkenler bulunur:
| Bağımsız değişken | Açıklama |
|---|---|
| istemini | Gerekli. İletişim kutusunda ileti olarak görüntülenen dize ifadesi. Kullanılan karakterlerin genişliğine bağlı olarak bilgi istemi uzunluğu üst sınırı yaklaşık 1024 karakter olabilir. İstem birden çok satırdan oluşuyorsa, her satır arasında bir satır başı karakteri (Chr(13)), bir satır besleme karakteri (Chr(10)) veya satır başı-satır besleme karakter birleşimini (Chr(13) & Chr(10)) kullanarak satırları ayırabilirsiniz. |
| Başlık | İsteğe bağlı. İletişim kutusunun başlık çubuğunda gösterilen dize ifadesi. Başlığı belirtmezseniz, uygulama adı başlık çubuğuna yerleştirilir. |
| varsayılan | İsteğe bağlı. Başka bir girdi sağlanmazsa varsayılan yanıt olarak metin kutusunda gösterilen dize ifadesi. Varsayılanı atlarsanız, metin kutusu boş görüntülenir. |
| xpos (XPOS) | İsteğe bağlı. İletişim kutusunun sol kenarının ekranın sol kenarına olan yatay uzaklığını twip cinsinden belirten sayısal ifade. XPOS belirtilmezse, iletişim kutusu yatay olarak ortalanır. |
| YPOS (YPOS) | İsteğe bağlı. İletişim kutusunun üst kenarının ekranın üst kısmından dikey uzaklığını twip olarak belirten sayısal ifade. Ypos'lar atlanırsa, iletişim kutusu ekranın yaklaşık üçte biri kadar dikey olarak konumlandırılır. |
| yardım dosyası | İsteğe bağlı. İletişim kutusuna bağlama duyarlı Yardım sağlamak için kullanılacak Yardım dosyasını tanımlayan dize ifadesi. Yardım dosyası sağlanırsa, bağlam da sağlanmalıdır. |
| bağlam | İsteğe bağlı. Yardım yazarı tarafından ilgili 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. |
Açıklamalar
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şuna basabilir. Bazı ana bilgisayar uygulamaları da iletişim kutusuna otomatik olarak bir Yardım düğmesi ekler. Kullanıcı Tamam'a tıklar veya ENTER tuşuna basarsa, InputBox işlevi metin kutusunun içinde ne varsa onu döndürür. Kullanıcı İptal'i tıklatırsa, işlev sıfır uzunlukta bir dize ("") döndürür.
Not
Adlandırılmış ilk bağımsız değişkenden daha fazlasını belirtmek için ifadede InputBox kullanmalısınız. Bazı konumsal bağımsız değişkenleri atlamak için, bunlara karşılık gelen virgül sınırlayıcısını da 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 istemek 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. Değişken MyValue , 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)