Interaction.MsgBox(Object, MsgBoxStyle, Object) Yöntem

Tanım

İletişim kutusunda bir ileti görüntüler, kullanıcının bir düğmeye tıklamasını bekler ve ardından kullanıcının hangi düğmeye tıkladığını gösteren bir tamsayı döndürür.

public static Microsoft.VisualBasic.MsgBoxResult MsgBox (object Prompt, Microsoft.VisualBasic.MsgBoxStyle Buttons = Microsoft.VisualBasic.MsgBoxStyle.OkOnly, object? Title = default);
public static Microsoft.VisualBasic.MsgBoxResult MsgBox (object Prompt, Microsoft.VisualBasic.MsgBoxStyle Buttons = Microsoft.VisualBasic.MsgBoxStyle.ApplicationModal, object Title = default);
static member MsgBox : obj * Microsoft.VisualBasic.MsgBoxStyle * obj -> Microsoft.VisualBasic.MsgBoxResult
Public Function MsgBox (Prompt As Object, Optional Buttons As MsgBoxStyle = Microsoft.VisualBasic.MsgBoxStyle.OkOnly, Optional Title As Object = Nothing) As MsgBoxResult
Public Function MsgBox (Prompt As Object, Optional Buttons As MsgBoxStyle = Microsoft.VisualBasic.MsgBoxStyle.ApplicationModal, Optional Title As Object = Nothing) As MsgBoxResult

Parametreler

Prompt
Object

Gereklidir. String ifadesi 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 karakter bileşimi (Chr(13) & Chr(10)) kullanarak satırları ayırabilirsiniz.

Buttons
MsgBoxStyle

İ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 modalitesini belirten değerlerin toplamı olan sayısal ifade. atlarsanız Buttons, varsayılan değer sıfırdır.

Title
Object

İ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.

Döndürülenler

Aşağıdaki değerlerden biri:

SabitDeğer
OK1
Cancel2
Abort3
Retry4
Ignore5
Yes6
No7

Özel durumlar

Prompt bir String ifade değil veya Title geçersiz.

İşlem Kullanıcı Etkileşimli modunda çalışmıyor.

Bir veya daha fazla parametre veya MsgBoxResultMsgBoxStyle sabit listesi üyesi değil.

Örnekler

Bu örnekte, evet ve hayır düğmeleri olan bir iletişim kutusunda kritik hata iletisi görüntülemek için işlevi kullanılır MsgBox . Hayır düğmesi varsayılan yanıt olarak belirtilir. Bu, sabit değerler tek bir sayısal ifadede birleştirilerek MsgBox yapılır. Bu durumda, 4 (Evet/Hayır düğme bileşimi) ve 16 ( Kritik İleti penceresi) ve 256 (varsayılan düğme olarak ikinci düğme) ekleyerek toplam 276 verir. İşlev tarafından MsgBox döndürülen değer, kullanıcı tarafından seçilen düğmeye bağlıdır: Evet, 6 değerini döndürür; Hayır, 7 değerini döndürür.

' The following example requires that Option Infer be set to On.

' Define the message you want to see inside the message box.
Dim msg = "Do you want to continue?"

' Display a simple message box.
MsgBox(msg)

' Define a title for the message box.
Dim title = "MsgBox Demonstration"

' Add the title to the display.
MsgBox(msg, , title)

' Now define a style for the message box. In this example, the
' message box will have Yes and No buttons, the default will be
' the No button, and a Critical Message icon will be present.
Dim style = MsgBoxStyle.YesNo Or MsgBoxStyle.DefaultButton2 Or
            MsgBoxStyle.Critical

' Display the message box and save the response, Yes or No.
Dim response = MsgBox(msg, style, title)

' Take some action based on the response.
If response = MsgBoxResult.Yes Then
    MsgBox("YES, continue!!", , title)
Else
    MsgBox("NO, stop!!", , title)
End If

Açıklamalar

Herhangi bir konumsal bağımsız değişkeni atlarsanız, karşılık gelen virgül sınırlayıcısını korumanız gerekir.

İletişim kutusunda İptal düğmesi görüntülüyorsa, ESC tuşuna basmak İptal'e tıklamayla 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 biri seçilene kadar hiçbir değer döndürülür. Windows Form uygulamalarında Yardım düğmesinin seçilmesi formun HelpRequested olayını yürütür.

Not

İşlev MsgBox , kısmi güven durumlarında yürütülmesini etkileyebilecek düzeyde gerektirir UIPermissionSafeTopLevelWindows . Daha fazla bilgi için bkz. UIPermission.

Numaralandırma MsgBoxStyle değerleri aşağıdaki tabloda listelenmiştir.

Üye Değer Açıklama
Üye Değer Açıklama
OKOnly 0 Yalnızca Tamam düğmesini görüntüler.
OKCancel 1 Tamam ve İptal düğmelerini görüntüler.
AbortRetryIgnore 2 Durdur, Yeniden Dene ve Yoksay düğmelerini görüntüler.
YesNoCancel 3 Evet, Hayır ve İptal düğmelerini görüntüler.
YesNo 4 Evet ve Hayır düğmelerini görüntüler.
RetryCancel 5 Yeniden Dene ve İptal düğmelerini görüntüler.
Critical 16 Kritik İleti simgesini görüntüler.
Question 32 Uyarı Sorgusu simgesini görüntüler.
Exclamation 48 Uyarı İletisi simgesini görüntüler.
Information 64 Bilgi İletisi simgesini görüntüler.
DefaultButton1 0 İlk düğme varsayılandır.
DefaultButton2 256 İkinci düğme varsayılandır.
DefaultButton3 512 Üçüncü düğme varsayılandır.
ApplicationModal 0 Uygulama kalıcıdır. Kullanıcının geçerli uygulamada çalışmaya devam etmeden önce ileti kutusunu yanıtlaması gerekir.
SystemModal 4096 Sistem kalıcıdır. Kullanıcı ileti kutusuna yanıt verene kadar tüm uygulamalar askıya alınır.
MsgBoxSetForeground 65536 İleti kutusu penceresini ön plan penceresi olarak belirtir.
MsgBoxRight 524288 Metin sağa hizalanmış.
MsgBoxRtlReading 1048576 Metnin İbranice ve Arapça sistemlerde sağdan sola okuma olarak görünmesi 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. İkinci grup (16, 32, 48, 64) simge stilini açıklar. Üçüncü grup (0, 256, 512) hangi düğmenin varsayılan olduğunu belirler. Dördüncü grup (0, 4096) ileti kutusunun modalitesini belirler ve beşinci grup, ileti kutusu penceresinin metnin hizalaması ve yönüyle birlikte ön plan penceresi olup olmadığını belirtir. Bağımsız değişken için son bir değer oluşturmak üzere Buttons sayılar eklerken, her gruptan yalnızca bir sayı kullanın.

Şunlara uygulanır

Ayrıca bkz.