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

Tanım

Ad Alanı:

Microsoft.VisualBasic

Bütünleştirilmiş Kod:

Microsoft.VisualBasic.Core.dll

Kaynak:

Interaction.vb

İ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);

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

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

MsgBoxResult

Aşağıdaki değerlerden biri:

Sabit	Değer
OK	1
Cancel	2
Abort	3
Retry	4
Ignore	5
Yes	6
No	7

Özel durumlar

ArgumentException

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

InvalidOperationException

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

InvalidEnumArgumentException

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.

Ayrıca bkz.

• InputBox(String, String, String, Int32, Int32)
• Show(String)