Access masaüstü veritabanında, MsgBox İşlevi iletişim kutusunda bir ileti görüntüler, kullanıcının bir düğmeye tıklamasını bekler ve kullanıcının hangi düğmeye tıkladığını gösteren bir Tamsayı döndürür.
Söz dizimi
MsgBox(prompt [, buttons ] [, title ] [, helpfile ] [, context ] )
MsgBox 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ı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 satırları ayırabilirsiniz. |
| düğmeler | İsteğe bağlı. görüntülenecek düğmelerin sayısını ve türünü, kullanılacak simge stilini, varsayılan düğmenin kimliğini ve ileti kutusunun kalıcılığını belirten değerlerin toplamı olan sayısal ifade. Atlanırsa, düğmelerin varsayılan değeri 0'dır. |
| 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. |
| 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. |
Ayarlar
Düğmelerbağımsız değişken ayarları şunlardır:
| Sabit | Değer | Açıklama |
|---|---|---|
| vbOKOnly | 0 | Yalnızca Tamam düğmesini görüntüle. |
| vbOKCancel | 1 | Tamam ve İptal düğmelerini görüntüleyin. |
| Vbabortretryıgnore | 2 | Durdur, Yeniden Dene ve Yoksay düğmelerini görüntüleyin. |
| vbYesNoCancel | 3 | Evet, Hayır ve İptal düğmelerini görüntüleyin. |
| Vbyesno | 4 | Evet ve Hayır düğmelerini görüntüleyin. |
| vbRetryCancel | 5 | Yeniden Dene ve İptal düğmelerini görüntüleyin. |
| vbCritical | 16 | Kritik İletiyi Görüntüle simgesi. |
| vbQuestion | 32 | Uyarı Sorgusu simgesini görüntüle. |
| vbExclamation | 48 | Uyarı İletisi simgesini görüntüle. |
| vbInformation | 64 | Görüntü Bilgileri İletisi simgesi. |
| vbDefaultButton1 | 0 | İlk düğme varsayılandır. |
| vbDefaultButton2 | 256 | İkinci düğme varsayılandır. |
| vbDefaultButton3 | 512 | Üçüncü düğme varsayılandır. |
| vbDefaultButton4 | 768 | Dördüncü düğme varsayılandır. |
| vbApplicationModal | 0 | Uygulama kalıcı; kullanıcının geçerli uygulamada çalışmaya devam etmeden önce ileti kutusuna yanıt vermesi gerekir. |
| vbSystemModal | 4096 | Sistem kalıcı; kullanıcı ileti kutusuna yanıt verene kadar tüm uygulamalar askıya alınır. |
| vbMsgBoxHelpButton | 16384 | İleti kutusuna Yardım düğmesi ekler |
| VbMsgBoxSetForeground | 65536 | İleti kutusu penceresini ön plan penceresi olarak belirtir |
| vbMsgBoxRight | 524288 | Metin sağa hizalanmış |
| vbMsgBoxRtlReading | 1048576 | Metnin İbranice ve Arapça sistemlerde sağdan sola okuma olarak gösterilmesi gerektiğini belirtir |
İlk değer grubu (0-5), iletişim kutusunda görüntülenen düğmelerin sayısını ve türünü açıklar; ikinci grup (16, 32, 48, 64) simge stilini açıklar; üçüncü grup (0, 256, 512) hangi düğmenin varsayılan olduğunu belirler; ve dördüncü grup (0, 4096) ileti kutusunun kalıcılığını belirler. Düğmeler bağımsız değişkeni için son bir değer oluşturmak üzere sayılar eklerken, her gruptan yalnızca bir sayı kullanın.
Not
Bu sabitler Visual Basic for Applications tarafından belirtilir. Sonuç olarak, adlar kodunuzda gerçek değerler yerine herhangi bir yerde kullanılabilir.
Dönüş Değerleri
| Sabit | Değer | Açıklama |
|---|---|---|
| vbOK | 1 | TAMAM |
| vbCancel | 2 | İptal |
| vbAbort | 3 | Iptal |
| vbRetry | 4 | Yeniden Dene |
| vbIgnore | 5 | Yoksay |
| vbYes | 6 | Evet |
| vbNo | 7 | Hayı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 (macOS) tuşlarına basabilir. Microsoft Excel gibi bazı konak uygulamaları da iletişim kutusuna otomatik olarak bir Yardım düğmesi ekler.
İletişim kutusunda İptal düğmesi görüntülüyorsa, ESC tuşuna basmak İptal'e tıklamakla aynı etkiye sahiptir. İletişim kutusunda Yardım düğmesi varsa, iletişim kutusu için bağlama duyarlı Yardım sağlanır. Ancak, diğer düğmelerden birine tıklanana kadar hiçbir değer döndürülür.
Not
İlk adlandırılmış bağımsız değişkenden daha fazlasını belirtmek için bir ifadede MsgBox 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.
Bu örnekte, Evet ve Hayır düğmelerine sahip bir iletişim kutusunda kritik hata iletisi görüntülemek için MsgBox işlevi kullanılır. Hayır düğmesi varsayılan yanıt olarak belirtilir.
MsgBox işlevi tarafından döndürülen değer, kullanıcı tarafından seçilen düğmeye bağlıdır. Bu örnekte, 'a DEMO.HLP eşit 1000bir Yardım bağlam numarasına sahip bir konu içeren bir Yardım dosyası olduğu varsayılır.
Dim Msg, Style, Title, Help, Ctxt, Response, MyString
Msg = "Do you want to continue?"
Style = vbYesNo + vbCritical + vbDefaultButton2
Title = "MsgBox Demonstration"
Help = "DEMO.HLP"
Ctxt = 1000
Response = MsgBox(Msg, Style, Title, Help, Ctxt)
If Response = vbYes Then ' User chose Yes.
MyString = "Yes" ' Perform some action.
Else ' User chose No.
MyString = "No" ' Perform some action.
End If