MessageBox.Show Yöntem

Başvuru

Tanım

Ad Alanı:: System.Windows.Forms

Bütünleştirilmiş Kod:: System.Windows.Forms.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

bir ileti kutusu görüntüler.

Aşırı Yüklemeler

Show(String)	Belirtilen metinle bir ileti kutusu görüntüler.
Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, String)	Belirtilen Yardım dosyasını ve Yardım anahtar sözcüğünü kullanarak belirtilen metin, başlık, düğmeler, simge, varsayılan düğme, seçenekler ve Yardım düğmesini içeren bir ileti kutusu görüntüler.
Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator, Object)	Belirtilen Yardım dosyasını`HelpNavigator`, ve Yardım konusunu kullanarak belirtilen metin, başlık, düğmeler, simge, varsayılan düğme, seçenekler ve Yardım düğmesini içeren bir ileti kutusu görüntüler.
Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String)	Belirtilen Yardım dosyasını kullanarak belirtilen metin, başlık, düğmeler, simge, varsayılan düğme, seçenekler ve Yardım düğmesini içeren bir ileti kutusu görüntüler.
Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator)	Belirtilen Yardım dosyasını ve `HelpNavigator`kullanarak belirtilen metin, başlık, düğmeler, simge, varsayılan düğme, seçenekler ve Yardım düğmesini içeren bir ileti kutusu görüntüler.
Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, String)	Belirtilen Yardım dosyasını ve Yardım anahtar sözcüğünü kullanarak belirtilen metin, başlık, düğmeler, simge, varsayılan düğme, seçenekler ve Yardım düğmesini içeren bir ileti kutusu görüntüler.
Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions)	Belirtilen nesnenin önünde ve belirtilen metin, başlık, düğmeler, simge, varsayılan düğme ve seçenekler içeren bir ileti kutusu görüntüler.
Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String)	Belirtilen Yardım dosyasını kullanarak belirtilen metin, başlık, düğmeler, simge, varsayılan düğme, seçenekler ve Yardım düğmesini içeren bir ileti kutusu görüntüler.
Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, Boolean)	Belirtilen metin, başlık, düğmeler, simge, varsayılan düğme, seçenekler ve Yardım düğmesini içeren bir ileti kutusu görüntüler.
Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator)	Belirtilen Yardım dosyasını ve `HelpNavigator`kullanarak belirtilen metin, başlık, düğmeler, simge, varsayılan düğme, seçenekler ve Yardım düğmesini içeren bir ileti kutusu görüntüler.
Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton)	Belirtilen nesnenin önünde ve belirtilen metin, başlık, düğmeler, simge ve varsayılan düğmeyle birlikte bir ileti kutusu görüntüler.
Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon)	Belirtilen nesnenin önünde ve belirtilen metin, başlık, düğmeler ve simgeyle birlikte bir ileti kutusu görüntüler.
Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton)	Belirtilen metin, başlık, düğmeler, simge ve varsayılan düğmeyi içeren bir ileti kutusu görüntüler.
Show(IWin32Window, String, String, MessageBoxButtons)	Belirtilen nesnenin önünde ve belirtilen metin, başlık ve düğmelerle birlikte bir ileti kutusu görüntüler.
Show(String, String, MessageBoxButtons, MessageBoxIcon)	Belirtilen metin, başlık, düğmeler ve simge içeren bir ileti kutusu görüntüler.
Show(IWin32Window, String, String)	Belirtilen nesnenin önünde, belirtilen metin ve başlık içeren bir ileti kutusu görüntüler.
Show(String, String, MessageBoxButtons)	Belirtilen metin, başlık ve düğmeler içeren bir ileti kutusu görüntüler.
Show(IWin32Window, String)	Belirtilen nesnenin önünde ve belirtilen metinle birlikte bir ileti kutusu görüntüler.
Show(String, String)	Belirtilen metin ve başlık içeren bir ileti kutusu görüntüler.
Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions)	Belirtilen metin, başlık, düğmeler, simge, varsayılan düğme ve seçenekleri içeren bir ileti kutusu görüntüler.
Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator, Object)	Belirtilen Yardım dosyasını`HelpNavigator`, ve Yardım konusunu kullanarak belirtilen metin, başlık, düğmeler, simge, varsayılan düğme, seçenekler ve Yardım düğmesini içeren bir ileti kutusu görüntüler.

Show(String)

Belirtilen metinle bir ileti kutusu görüntüler.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text);

public static System.Windows.Forms.DialogResult Show (string text);

public static System.Windows.Forms.DialogResult Show (string? text);

static member Show : string -> System.Windows.Forms.DialogResult

Public Shared Function Show (text As String) As DialogResult

Parametreler

text: String

İleti kutusunda görüntülenecek metin.

Döndürülenler

DialogResult

Değerlerden DialogResult biri.

Örnekler

Aşağıdaki kod örneği basit bir ileti kutusu görüntüler.

private void DisplayMessageBoxText()
{
         MessageBox.Show("Hello, world.");
}

Private Sub DisplayMessageBoxText()

    MessageBox.Show("Hello, world.")
End Sub

Açıklamalar

Varsayılan olarak, ileti kutusunda Tamam düğmesi görüntülenir. İleti kutusu başlıkta bir başlık içermiyor.

Şunlara uygulanır

Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, String)

Belirtilen Yardım dosyasını ve Yardım anahtar sözcüğünü kullanarak belirtilen metin, başlık, düğmeler, simge, varsayılan düğme, seçenekler ve Yardım düğmesini içeren bir ileti kutusu görüntüler.

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, System::String ^ helpFilePath, System::String ^ keyword);

public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, string keyword);

public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window? owner, string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, string keyword);

static member Show : System.Windows.Forms.IWin32Window * string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * string * string -> System.Windows.Forms.DialogResult

Public Shared Function Show (owner As IWin32Window, text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, helpFilePath As String, keyword As String) As DialogResult

Parametreler

owner: IWin32Window

Bunun uygulaması IWin32Window kalıcı iletişim kutusuna sahip olur.

text: String

İleti kutusunda görüntülenecek metin.

caption: String

İleti kutusunun başlık çubuğunda görüntülenecek metin.

buttons: MessageBoxButtons

MessageBoxButtons İleti kutusunda hangi düğmelerin görüntüleneceğini belirten değerlerden biri.

icon: MessageBoxIcon

İleti kutusunda hangi simgenin MessageBoxIcon görüntüleneceğini belirten değerlerden biri.

defaultButton: MessageBoxDefaultButton

MessageBoxDefaultButton İleti kutusu için varsayılan düğmeyi belirten değerlerden biri.

options: MessageBoxOptions

MessageBoxOptions İleti kutusu için hangi görüntüleme ve ilişkilendirme seçeneklerinin kullanılacağını belirten değerlerden biri. Varsayılan değerleri kullanmak isterseniz 0'ı geçirebilirsiniz.

helpFilePath: String

Kullanıcı Yardım düğmesine tıkladığında görüntülenecek Yardım dosyasının yolu ve adı.

keyword: String

Kullanıcı Yardım düğmesine tıkladığında görüntülenecek Yardım anahtar sözcüğü.

Döndürülenler

DialogResult

Değerlerden DialogResult biri.

Özel durumlar

InvalidEnumArgumentException

buttons öğesinin MessageBoxButtonsüyesi değil.

-veya-

icon öğesinin MessageBoxIconüyesi değil.

-veya-

Belirtilen defaultButton öğesinin üyesi MessageBoxDefaultButtondeğil.

InvalidOperationException

Kullanıcı Etkileşimli modunda çalışmayan bir işlemde görüntüleme MessageBox girişiminde bulunuldu. Bu özellik tarafından UserInteractive belirtilir.

ArgumentException

optionshem ServiceNotificationhem de DefaultDesktopOnly belirtildi.

-veya-

buttons geçersiz bir bileşimi belirtti MessageBoxButtons.

Örnekler

Aşağıdaki kod örneği, ana pencereye üst öğe eklenmiş bir ileti kutusunun nasıl göstereceğini gösterir. İleti kutusunda bir Yardım düğmesi görüntülenir. Kullanıcı Yardım düğmesine tıkladığında, Mspaint.chm Yardım dosyası açılır ve anahtar sözcük tarafından mspaint.chm::/paint_brush.htm tanımlanan konu görüntülenir. Örnek, Yardım dosyasının Mspaint.chm yüklü olmasını gerektirir.

#using <System.dll>
#using <System.Windows.Forms.dll>
#using <System.Drawing.dll>

using namespace System;
using namespace System::Drawing;
using namespace System::ComponentModel;
using namespace System::Windows::Forms;

using System;
using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;

Imports System.Drawing
Imports System.ComponentModel
Imports System.Windows.Forms

// Display message box parented to the main form. 
// The Help button opens the Mspaint.chm Help file, 
// and the "mspaint.chm::/paint_brush.htm" Help keyword shows the 
// associated topic.
System::Windows::Forms::DialogResult r8 = MessageBox::Show( this, "Message with Help file and keyword.", "Help Caption", MessageBoxButtons::OK, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, (MessageBoxOptions)0, "mspaint.chm", "mspaint.chm::/paint_brush.htm" );

// Display message box parented to the main form. 
// The Help button opens the Mspaint.chm Help file, 
// and the "mspaint.chm::/paint_brush.htm" Help keyword shows the 
// associated topic.
DialogResult r8 = MessageBox.Show (this, "Message with Help file and keyword.", 
                                   "Help Caption", MessageBoxButtons.OK, 
                                   MessageBoxIcon.Question, 
                                   MessageBoxDefaultButton.Button1, 0, 
                                   "mspaint.chm", 
                                   "mspaint.chm::/paint_brush.htm");

' Display message box parented to the main form. 
' The Help button opens the Mspaint.chm Help file, 
' and the "mspaint.chm::/paint_brush.htm" Help keyword shows the 
' associated topic.
Dim r8 As DialogResult = MessageBox.Show(Me, "Message with Help file and keyword.", _
                                   "Help Caption", MessageBoxButtons.OK, _
                                   MessageBoxIcon.Question, _
                                   MessageBoxDefaultButton.Button1, 0, _
                                   "mspaint.chm", _
                                   "mspaint.chm::/paint_brush.htm")

Açıklamalar

İleti kutusu kalıcı bir iletişim kutusudur; başka bir deyişle kalıcı formdaki nesneler dışında hiçbir giriş (klavye veya fare tıklaması) gerçekleşemez. Başka bir forma giriş yapılabilmesi için programın kalıcı formu (genellikle bazı kullanıcı eylemlerine yanıt olarak) gizlemesi veya kapatması gerekir. parametresini owner kullanarak, iletişim kutusunun en üst düzey sahibi olarak görev yapacak arabirimini uygulayan IWin32Window belirli bir nesneyi belirtebilirsiniz.

Kullanıcı Yardım düğmesine tıkladığında, parametresinde helpFilePath belirtilen Yardım dosyası açılır ve parametre tarafından keyword tanımlanan Yardım anahtar sözcüğü konusu görüntülenir. İleti kutusunun (veya etkin formun) sahibi olan form da olayı alır HelpRequested .

Ayrıca bkz.

Şunlara uygulanır

Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator, Object)

Belirtilen Yardım dosyasınıHelpNavigator, ve Yardım konusunu kullanarak belirtilen metin, başlık, düğmeler, simge, varsayılan düğme, seçenekler ve Yardım düğmesini içeren bir ileti kutusu görüntüler.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, System::String ^ helpFilePath, System::Windows::Forms::HelpNavigator navigator, System::Object ^ param);

public static System.Windows.Forms.DialogResult Show (string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, System.Windows.Forms.HelpNavigator navigator, object param);

public static System.Windows.Forms.DialogResult Show (string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, System.Windows.Forms.HelpNavigator navigator, object? param);

static member Show : string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * string * System.Windows.Forms.HelpNavigator * obj -> System.Windows.Forms.DialogResult

Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, helpFilePath As String, navigator As HelpNavigator, param As Object) As DialogResult

Parametreler

text: String

İleti kutusunda görüntülenecek metin.

caption: String

İleti kutusunun başlık çubuğunda görüntülenecek metin.

buttons: MessageBoxButtons

MessageBoxButtons İleti kutusunda hangi düğmelerin görüntüleneceğini belirten değerlerden biri.

icon: MessageBoxIcon

İleti kutusunda hangi simgenin MessageBoxIcon görüntüleneceğini belirten değerlerden biri.

defaultButton: MessageBoxDefaultButton

MessageBoxDefaultButton İleti kutusu için varsayılan düğmeyi belirten değerlerden biri.

options: MessageBoxOptions

helpFilePath: String

Kullanıcı Yardım düğmesine tıkladığında görüntülenecek Yardım dosyasının yolu ve adı.

navigator: HelpNavigator

Değerlerden HelpNavigator biri.

param: Object

Kullanıcı Yardım düğmesine tıkladığında görüntülenecek Yardım konusunun sayısal kimliği.

Döndürülenler

DialogResult

Değerlerden DialogResult biri.

Özel durumlar

InvalidEnumArgumentException

buttons öğesinin MessageBoxButtonsüyesi değil.

-veya-

icon öğesinin MessageBoxIconüyesi değil.

-veya-

Belirtilen defaultButton öğesinin üyesi MessageBoxDefaultButtondeğil.

InvalidOperationException

Kullanıcı Etkileşimli modunda çalışmayan bir işlemde görüntüleme MessageBox girişiminde bulunuldu. Bu özellik tarafından UserInteractive belirtilir.

ArgumentException

optionshem ServiceNotificationhem de DefaultDesktopOnly belirtildi.

-veya-

buttons geçersiz bir bileşimi belirtti MessageBoxButtons.

Örnekler

Aşağıdaki kod örneği, Yardım düğmesi içeren bir ileti kutusunun nasıl göstereceğini gösterir. Kullanıcı Yardım düğmesine tıkladığında, Mspaint.chm Yardım dosyası açılır ve Yardım dizini sekmesi ile anahtar sözcük tarafından ovals tanımlanan konu görüntülenir. Örnek, Yardım dosyasının Mspaint.chm yüklü olmasını gerektirir.

#using <System.dll>
#using <System.Windows.Forms.dll>
#using <System.Drawing.dll>

using namespace System;
using namespace System::Drawing;
using namespace System::ComponentModel;
using namespace System::Windows::Forms;

using System;
using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;

Imports System.Drawing
Imports System.ComponentModel
Imports System.Windows.Forms

// Display a message box. The Help button opens the Mspaint.chm Help file, 
// shows index with the "ovals" keyword selected, and displays the
// associated topic.
System::Windows::Forms::DialogResult r5 = MessageBox::Show( "Message with Help file and Help navigator with additional parameter.", "Help Caption", MessageBoxButtons::OK, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, (MessageBoxOptions)0, "mspaint.chm", HelpNavigator::KeywordIndex, "ovals" );

// Display a message box. The Help button opens the Mspaint.chm Help file, 
// shows index with the "ovals" keyword selected, and displays the
// associated topic.
DialogResult r5 = MessageBox.Show ("Message with Help file and Help navigator with additional parameter.", 
                                   "Help Caption", MessageBoxButtons.OK, 
                                   MessageBoxIcon.Question, 
                                   MessageBoxDefaultButton.Button1, 
                                   0, "mspaint.chm", 
                                   HelpNavigator.KeywordIndex, "ovals");

' Display a message box. The Help button opens the Mspaint.chm Help file, 
' shows index with the "ovals" keyword selected, and displays the
' associated topic.
Dim r5 As DialogResult = MessageBox.Show("Message with Help file and Help navigator with additional parameter.", _
                                   "Help Caption", MessageBoxButtons.OK, _
                                   MessageBoxIcon.Question, _
                                   MessageBoxDefaultButton.Button1, _
                                   0, "mspaint.chm", _
                                   HelpNavigator.KeywordIndex, "ovals")

Açıklamalar

Kullanıcı Yardım düğmesine tıkladığında, parametresinde helpFilePath belirtilen Yardım dosyası açılır ve parametre tarafından navigator tanımlanan Yardım içeriği görüntülenir. İleti kutusunun (veya etkin formun) sahibi olan form da olayı alır HelpRequested .

Derlenmiş yardım dosyaları sayfalarda içindekiler tablosu, dizin, arama ve anahtar sözcük bağlantıları sağlar. için navigatoraşağıdaki değerleri kullanabilirsiniz: TableOfContents, Find, Indexveya Topic.

komutunun daha fazla geliştirmesini Topic sağlamak için komutunu kullanabilirsinizparam. parametresinde navigator belirtilen değer , Indexveya FindiseTableOfContents, bu değer olmalıdırnull. navigator parametresi başvuruda bulunursaTopic, bu değer görüntülenecek konunun sayısal değerini içeren bir nesneye başvurmalıdır.

helpFilePath Parametre C:\path\sample.chm veya /folder/file.htm biçiminde olabilir.

Ayrıca bkz.

Şunlara uygulanır

Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String)

Belirtilen Yardım dosyasını kullanarak belirtilen metin, başlık, düğmeler, simge, varsayılan düğme, seçenekler ve Yardım düğmesini içeren bir ileti kutusu görüntüler.

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, System::String ^ helpFilePath);

public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath);

public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window? owner, string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath);

static member Show : System.Windows.Forms.IWin32Window * string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * string -> System.Windows.Forms.DialogResult

Public Shared Function Show (owner As IWin32Window, text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, helpFilePath As String) As DialogResult

Parametreler

owner: IWin32Window

Bunun uygulaması IWin32Window kalıcı iletişim kutusuna sahip olur.

text: String

İleti kutusunda görüntülenecek metin.

caption: String

İleti kutusunun başlık çubuğunda görüntülenecek metin.

buttons: MessageBoxButtons

MessageBoxButtons İleti kutusunda hangi düğmelerin görüntüleneceğini belirten değerlerden biri.

icon: MessageBoxIcon

İleti kutusunda hangi simgenin MessageBoxIcon görüntüleneceğini belirten değerlerden biri.

defaultButton: MessageBoxDefaultButton

MessageBoxDefaultButton İleti kutusu için varsayılan düğmeyi belirten değerlerden biri.

options: MessageBoxOptions

helpFilePath: String

Kullanıcı Yardım düğmesine tıkladığında görüntülenecek Yardım dosyasının yolu ve adı.

Döndürülenler

DialogResult

Değerlerden DialogResult biri.

Özel durumlar

InvalidEnumArgumentException

buttons öğesinin MessageBoxButtonsüyesi değil.

-veya-

icon öğesinin MessageBoxIconüyesi değil.

-veya-

Belirtilen defaultButton öğesinin üyesi MessageBoxDefaultButtondeğil.

InvalidOperationException

Kullanıcı Etkileşimli modunda çalışmayan bir işlemde görüntüleme MessageBox girişiminde bulunuldu. Bu özellik tarafından UserInteractive belirtilir.

ArgumentException

optionshem ServiceNotificationhem de DefaultDesktopOnly belirtildi.

-veya-

buttons geçersiz bir bileşimi belirtti MessageBoxButtons.

Örnekler

Aşağıdaki kod örneği, ana forma üst öğe eklenmiş bir ileti kutusunun nasıl gösterildiğini gösterir. İleti kutusunda bir Yardım düğmesi görüntülenir. Kullanıcı Yardım düğmesine Mspaint.chm tıkladığında Yardım dosyası açılır. Örnek, Yardım dosyasının Mspaint.chm yüklü olmasını gerektirir.

#using <System.dll>
#using <System.Windows.Forms.dll>
#using <System.Drawing.dll>

using namespace System;
using namespace System::Drawing;
using namespace System::ComponentModel;
using namespace System::Windows::Forms;

using System;
using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;

Imports System.Drawing
Imports System.ComponentModel
Imports System.Windows.Forms

// Display a message box parented to the main form. 
// The Help button opens the Mspaint.chm Help file.
System::Windows::Forms::DialogResult r2 = MessageBox::Show( this, "Message with Help file.", "Help Caption", MessageBoxButtons::OK, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, (MessageBoxOptions)0, "mspaint.chm" );

// Display a message box parented to the main form. 
// The Help button opens the Mspaint.chm Help file.
DialogResult r2 = MessageBox.Show (this, "Message with Help file.", 
                                   "Help Caption", MessageBoxButtons.OK, 
                                   MessageBoxIcon.Question, 
                                   MessageBoxDefaultButton.Button1, 
                                   0, 
                                   "mspaint.chm");

' Display a message box parented to the main form. 
' The Help button opens the Mspaint.chm Help file.
Dim r2 As DialogResult = MessageBox.Show(Me, "Message with Help file.", _
                                   "Help Caption", MessageBoxButtons.OK, _
                                   MessageBoxIcon.Question, _
                                   MessageBoxDefaultButton.Button1, _
                                   0, _
                                   "mspaint.chm")

Açıklamalar

İleti kutusu kalıcı bir iletişim kutusudur; başka bir deyişle kalıcı formdaki nesneler dışında hiçbir giriş (klavye veya fare tıklaması) gerçekleşemez. Başka bir forma giriş yapılabilmesi için programın kalıcı formu (genellikle bazı kullanıcı eylemlerine yanıt olarak) gizlemesi veya kapatması gerekir. parametresini owner , iletişim kutusunun en üst düzey penceresi ve sahibi olarak görev yapacak arabirimini uygulayan IWin32Window belirli bir nesneyi belirtmek için kullanabilirsiniz.

Kullanıcı Yardım düğmesine tıkladığında, parametresinde helpFilePath belirtilen Yardım dosyası açılır. İleti kutusunun (veya etkin formun) sahibi olan form da olayı alır HelpRequested .

helpFilePath Parametre C:\path\sample.chm veya /folder/file.htm biçiminde olabilir.

Ayrıca bkz.

Şunlara uygulanır

Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator)

Belirtilen Yardım dosyasını ve HelpNavigatorkullanarak belirtilen metin, başlık, düğmeler, simge, varsayılan düğme, seçenekler ve Yardım düğmesini içeren bir ileti kutusu görüntüler.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, System::String ^ helpFilePath, System::Windows::Forms::HelpNavigator navigator);

public static System.Windows.Forms.DialogResult Show (string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, System.Windows.Forms.HelpNavigator navigator);

public static System.Windows.Forms.DialogResult Show (string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, System.Windows.Forms.HelpNavigator navigator);

static member Show : string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * string * System.Windows.Forms.HelpNavigator -> System.Windows.Forms.DialogResult

Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, helpFilePath As String, navigator As HelpNavigator) As DialogResult

Parametreler

text: String

İleti kutusunda görüntülenecek metin.

caption: String

İleti kutusunun başlık çubuğunda görüntülenecek metin.

buttons: MessageBoxButtons

MessageBoxButtons İleti kutusunda hangi düğmelerin görüntüleneceğini belirten değerlerden biri.

icon: MessageBoxIcon

İleti kutusunda hangi simgenin MessageBoxIcon görüntüleneceğini belirten değerlerden biri.

defaultButton: MessageBoxDefaultButton

MessageBoxDefaultButton İleti kutusu için varsayılan düğmeyi belirten değerlerden biri.

options: MessageBoxOptions

helpFilePath: String

Kullanıcı Yardım düğmesine tıkladığında görüntülenecek Yardım dosyasının yolu ve adı.

navigator: HelpNavigator

Değerlerden HelpNavigator biri.

Döndürülenler

DialogResult

Değerlerden DialogResult biri.

Özel durumlar

InvalidEnumArgumentException

buttons öğesinin MessageBoxButtonsüyesi değil.

-veya-

icon öğesinin MessageBoxIconüyesi değil.

-veya-

Belirtilen defaultButton öğesinin üyesi MessageBoxDefaultButtondeğil.

InvalidOperationException

Kullanıcı Etkileşimli modunda çalışmayan bir işlemde görüntüleme MessageBox girişiminde bulunuldu. Bu özellik tarafından UserInteractive belirtilir.

ArgumentException

optionshem ServiceNotificationhem de DefaultDesktopOnly belirtildi.

-veya-

buttons geçersiz bir bileşimi belirtti MessageBoxButtons.

Örnekler

Aşağıdaki kod örneği, Yardım düğmesi içeren bir ileti kutusunun nasıl göstereceğini gösterir. Kullanıcı Yardım düğmesine tıkladığında, Mspaint.chm Yardım dosyası açılır ve Yardım dizini sekmesi görüntülenir. Örnek, Yardım dosyasının Mspaint.chm yüklü olmasını gerektirir.

#using <System.dll>
#using <System.Windows.Forms.dll>
#using <System.Drawing.dll>

using namespace System;
using namespace System::Drawing;
using namespace System::ComponentModel;
using namespace System::Windows::Forms;

using System;
using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;

Imports System.Drawing
Imports System.ComponentModel
Imports System.Windows.Forms

// Display a message box. The Help button opens 
// the Mspaint.chm Help file and shows the Help contents 
// on the Index tab.
System::Windows::Forms::DialogResult r3 = MessageBox::Show( "Message with Help file and Help navigator.", "Help Caption", MessageBoxButtons::OK, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, (MessageBoxOptions)0, "mspaint.chm", HelpNavigator::Index );

// Display a message box. The Help button opens 
// the Mspaint.chm Help file and shows the Help contents 
// on the Index tab.
DialogResult r3 = MessageBox.Show ("Message with Help file and Help navigator.", 
                                   "Help Caption", MessageBoxButtons.OK,
                                   MessageBoxIcon.Question, 
                                   MessageBoxDefaultButton.Button1, 
                                   0, "mspaint.chm", 
                                   HelpNavigator.Index);

' Display a message box. The Help button opens 
' the Mspaint.chm Help file and shows the Help contents 
' on the Index tab.
Dim r3 As DialogResult = MessageBox.Show("Message with Help file and Help navigator.", _
                                   "Help Caption", MessageBoxButtons.OK, _
                                   MessageBoxIcon.Question, _
                                   MessageBoxDefaultButton.Button1, _
                                   0, "mspaint.chm", _
                                   HelpNavigator.Index)

Açıklamalar

Kullanıcı Yardım düğmesine tıkladığında, parametresinde helpFilePath belirtilen yardım dosyası açılır ve parametre tarafından navigator tanımlanan Yardım içeriği görüntülenir. İleti kutusunun (veya etkin formun) sahibi olan form da olayı alır HelpRequested .

Derlenmiş Yardım dosyaları sayfalarda içindekiler tablosu, dizin, arama ve anahtar sözcük bağlantıları sağlar. için navigatoraşağıdaki değerleri kullanabilirsiniz: TableOfContents, Find, Indexveya Topic.

helpFilePath Parametre C:\path\sample.chm veya /folder/file.htm biçiminde olabilir.

Ayrıca bkz.

Şunlara uygulanır

Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, String)

Belirtilen Yardım dosyasını ve Yardım anahtar sözcüğünü kullanarak belirtilen metin, başlık, düğmeler, simge, varsayılan düğme, seçenekler ve Yardım düğmesi içeren bir ileti kutusu görüntüler.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, System::String ^ helpFilePath, System::String ^ keyword);

public static System.Windows.Forms.DialogResult Show (string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, string keyword);

public static System.Windows.Forms.DialogResult Show (string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, string keyword);

static member Show : string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * string * string -> System.Windows.Forms.DialogResult

Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, helpFilePath As String, keyword As String) As DialogResult

Parametreler

text: String

İleti kutusunda görüntülenecek metin.

caption: String

İleti kutusunun başlık çubuğunda görüntülenecek metin.

buttons: MessageBoxButtons

MessageBoxButtons İleti kutusunda hangi düğmelerin görüntüleneceğini belirten değerlerden biri.

icon: MessageBoxIcon

İleti kutusunda hangi simgenin MessageBoxIcon görüntüleneceğini belirten değerlerden biri.

defaultButton: MessageBoxDefaultButton

MessageBoxDefaultButton İleti kutusu için varsayılan düğmeyi belirten değerlerden biri.

options: MessageBoxOptions

helpFilePath: String

Kullanıcı Yardım düğmesine tıkladığında görüntülenecek Yardım dosyasının yolu ve adı.

keyword: String

Kullanıcı Yardım düğmesine tıkladığında görüntülenecek Yardım anahtar sözcüğü.

Döndürülenler

DialogResult

Değerlerden DialogResult biri.

Özel durumlar

InvalidEnumArgumentException

buttons öğesinin MessageBoxButtonsüyesi değil.

-veya-

icon öğesinin MessageBoxIconüyesi değil.

-veya-

Belirtilen defaultButton öğesinin üyesi MessageBoxDefaultButtondeğil.

InvalidOperationException

Kullanıcı Etkileşimli modunda çalışmayan bir işlemde görüntüleme MessageBox girişiminde bulunuldu. Bu özellik tarafından UserInteractive belirtilir.

ArgumentException

optionshem ServiceNotificationhem de DefaultDesktopOnly belirtildi.

-veya-

buttons geçersiz bir bileşimi belirtti MessageBoxButtons.

Örnekler

Aşağıdaki kod örneği, Yardım düğmesi içeren bir ileti kutusunun nasıl göstereceğini gösterir. Kullanıcı Yardım düğmesine tıkladığında, Mspaint.chm Yardım dosyası açılır ve anahtar sözcük tarafından mspaint.chm::/paint_brush.htm tanımlanan konu görüntülenir. Örnek, Yardım dosyasının Mspaint.chm yüklü olmasını gerektirir.

#using <System.dll>
#using <System.Windows.Forms.dll>
#using <System.Drawing.dll>

using namespace System;
using namespace System::Drawing;
using namespace System::ComponentModel;
using namespace System::Windows::Forms;

using System;
using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;

Imports System.Drawing
Imports System.ComponentModel
Imports System.Windows.Forms

// Display a message box. The Help button opens the Mspaint.chm Help file, 
// and the "mspaint.chm::/paint_brush.htm" Help keyword shows the 
// associated topic.
System::Windows::Forms::DialogResult r7 = MessageBox::Show( "Message with Help file and keyword.", "Help Caption", MessageBoxButtons::OK, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, (MessageBoxOptions)0, "mspaint.chm", "mspaint.chm::/paint_brush.htm" );

// Display a message box. The Help button opens the Mspaint.chm Help file, 
// and the "mspaint.chm::/paint_brush.htm" Help keyword shows the 
// associated topic.
DialogResult r7 = MessageBox.Show ("Message with Help file and keyword.", 
                                   "Help Caption", MessageBoxButtons.OK, 
                                   MessageBoxIcon.Question, 
                                   MessageBoxDefaultButton.Button1, 0, 
                                   "mspaint.chm", 
                                   "mspaint.chm::/paint_brush.htm");

' Display a message box. The Help button opens the Mspaint.chm Help file, 
' and the "mspaint.chm::/paint_brush.htm" Help keyword shows the 
' associated topic.
Dim r7 As DialogResult = MessageBox.Show("Message with Help file and keyword.", _
                                   "Help Caption", MessageBoxButtons.OK, _
                                   MessageBoxIcon.Question, _
                                   MessageBoxDefaultButton.Button1, 0, _
                                   "mspaint.chm", _
                                   "mspaint.chm::/paint_brush.htm")

Açıklamalar

Kullanıcı Yardım düğmesine tıkladığında, parametresinde helpFilePath belirtilen Yardım dosyası açılır ve parametresi tarafından keyword tanımlanan Yardım anahtar sözcüğü konusu görüntülenir. İleti kutusunun (veya etkin formun) sahibi olan form da olayı alır HelpRequested .

Ayrıca bkz.

Şunlara uygulanır

Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions)

Belirtilen nesnenin önünde ve belirtilen metin, başlık, düğmeler, simge, varsayılan düğme ve seçeneklerle birlikte bir ileti kutusu görüntüler.

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options);

public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options);

public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window? owner, string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options);

static member Show : System.Windows.Forms.IWin32Window * string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions -> System.Windows.Forms.DialogResult

Public Shared Function Show (owner As IWin32Window, text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions) As DialogResult

Parametreler

owner: IWin32Window

Bunun bir IWin32Window uygulaması kalıcı iletişim kutusuna sahip olur.

text: String

İleti kutusunda görüntülenecek metin.

caption: String

İleti kutusunun başlık çubuğunda görüntülenecek metin.

buttons: MessageBoxButtons

MessageBoxButtons İleti kutusunda hangi düğmelerin görüntüleneceğini belirten değerlerden biri.

icon: MessageBoxIcon

İleti kutusunda hangi simgenin MessageBoxIcon görüntüleneceğini belirten değerlerden biri.

defaultButton: MessageBoxDefaultButton

değerlerinden MessageBoxDefaultButton biri, ileti kutusu için varsayılan düğmeyi belirtir.

options: MessageBoxOptions

Döndürülenler

DialogResult

Değerlerden DialogResult biri.

Özel durumlar

InvalidEnumArgumentException

buttons öğesinin MessageBoxButtonsüyesi değil.

-veya-

icon öğesinin MessageBoxIconüyesi değil.

-veya-

defaultButton öğesinin MessageBoxDefaultButtonüyesi değil.

InvalidOperationException

Kullanıcı Etkileşimli modunda çalışmayan bir işlemde görüntüleme MessageBox girişiminde bulunuldu. Bu özellik tarafından UserInteractive belirtilir.

ArgumentException

optionshem ServiceNotificationhem de DefaultDesktopOnly belirtildi.

-veya-

options DefaultDesktopOnly veya ServiceNotification parametresinde owner bir değer belirtti. Bu iki seçenek yalnızca bu yöntemin parametre owner almayan sürümünü çağırırsanız kullanılmalıdır.

-veya-

buttons geçersiz bir birleşimi belirtti MessageBoxButtons.

Örnekler

Aşağıdaki kod örneği, öğesinin bu aşırı yüklemesi Showtarafından desteklenen seçeneklerle nasıl görüntüleneceğini MessageBox gösterir. dize değişkeninin ServerNameboş olduğunu doğruladıktan sonra, örnekte kullanıcıya işlemi iptal etme seçeneği sunan bir MessageBoxgörüntülenir. Yöntemin Show dönüş değeri olarak değerlendirilirse Yes, öğesini görüntüleyen MessageBox form kapatılır.

private:
   void validateUserEntry2()
   {
      // Checks the value of the text.
      if ( serverName->Text->Length == 0 )
      {
         // Initializes the variables to pass to the MessageBox::Show method.
         String^ message = "You did not enter a server name. Cancel this operation?";
         String^ caption = "No Server Name Specified";
         MessageBoxButtons buttons = MessageBoxButtons::YesNo;
         System::Windows::Forms::DialogResult result;
         
         // Displays the MessageBox.
         result = MessageBox::Show( this, message, caption, buttons, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, MessageBoxOptions::RightAlign );
         if ( result == ::DialogResult::Yes )
         {
            // Closes the parent form.
            this->Close();
         }
      }
   }


private void validateUserEntry2()
{

    // Checks the value of the text.

    if(serverName.Text.Length == 0)
    {

        // Initializes the variables to pass to the MessageBox.Show method.

        string message = "You did not enter a server name. Cancel this operation?";
        string caption = "No Server Name Specified";
        MessageBoxButtons buttons = MessageBoxButtons.YesNo;
        DialogResult result;

        // Displays the MessageBox.

        result = MessageBox.Show(this, message, caption, buttons,
            MessageBoxIcon.Question, MessageBoxDefaultButton.Button1, 
            MessageBoxOptions.RightAlign);

        if(result == DialogResult.Yes)
        {

            // Closes the parent form.

            this.Close();
        }
    }
}

Private Sub ValidateUserEntry2()


    ' Checks the value of the text.

    If ServerName.Text.Length = 0 Then

        ' Initializes variables to pass to the MessageBox.Show method.

        Dim Message As String = "You did not enter a server name. Cancel this operation?"
        Dim Caption As String = "No Server Name Specified"
        Dim Buttons As Integer = MessageBoxButtons.YesNo

        Dim Result As DialogResult

        'Displays a MessageBox using the Question icon and specifying the No button as the default.

        Result = MessageBox.Show(Me, Message, Caption, MessageBoxButtons.YesNo, _
            MessageBoxIcon.Question, MessageBoxDefaultButton.Button1, MessageBoxOptions.RightAlign)


        ' Gets the result of the MessageBox display.

        If Result = System.Windows.Forms.DialogResult.Yes Then

            ' Closes the parent form.

            Me.Close()

        End If

    End If

End Sub

Açıklamalar

parametresini owner , iletişim kutusunun en üst düzey penceresi ve sahibi olarak görev yapacak arabirimi uygulayan IWin32Window belirli bir nesneyi belirtmek için kullanabilirsiniz. İleti kutusu kalıcı bir iletişim kutusudur; başka bir deyişle, kalıcı formdaki nesneler dışında hiçbir giriş (klavye veya fare tıklaması) gerçekleşemez. Başka bir forma giriş yapılabilmesi için programın kalıcı formu gizlemesi veya kapatması gerekir (genellikle bazı kullanıcı eylemlerine yanıt olarak).

İleti kutusunda en fazla üç düğme olabilir.

Ayrıca bkz.

Şunlara uygulanır

Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String)

Belirtilen Yardım dosyasını kullanarak belirtilen metin, başlık, düğmeler, simge, varsayılan düğme, seçenekler ve Yardım düğmesi içeren bir ileti kutusu görüntüler.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, System::String ^ helpFilePath);

public static System.Windows.Forms.DialogResult Show (string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath);

public static System.Windows.Forms.DialogResult Show (string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath);

static member Show : string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * string -> System.Windows.Forms.DialogResult

Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, helpFilePath As String) As DialogResult

Parametreler

text: String

İleti kutusunda görüntülenecek metin.

caption: String

İleti kutusunun başlık çubuğunda görüntülenecek metin.

buttons: MessageBoxButtons

MessageBoxButtons İleti kutusunda hangi düğmelerin görüntüleneceğini belirten değerlerden biri.

icon: MessageBoxIcon

İleti kutusunda hangi simgenin MessageBoxIcon görüntüleneceğini belirten değerlerden biri.

defaultButton: MessageBoxDefaultButton

MessageBoxDefaultButton İleti kutusu için varsayılan düğmeyi belirten değerlerden biri.

options: MessageBoxOptions

helpFilePath: String

Kullanıcı Yardım düğmesine tıkladığında görüntülenecek Yardım dosyasının yolu ve adı.

Döndürülenler

DialogResult

Değerlerden DialogResult biri.

Özel durumlar

InvalidEnumArgumentException

buttons öğesinin MessageBoxButtonsüyesi değil.

-veya-

icon öğesinin MessageBoxIconüyesi değil.

-veya-

Belirtilen defaultButton öğesinin üyesi MessageBoxDefaultButtondeğil.

InvalidOperationException

Kullanıcı Etkileşimli modunda çalışmayan bir işlemde görüntüleme MessageBox girişiminde bulunuldu. Bu özellik tarafından UserInteractive belirtilir.

ArgumentException

optionshem ServiceNotificationhem de DefaultDesktopOnly belirtildi.

-veya-

buttons geçersiz bir birleşimi belirtti MessageBoxButtons.

Örnekler

Aşağıdaki kod örneği, Yardım düğmesi olan bir ileti kutusunun nasıl göstereceğini gösterir. Kullanıcı Yardım düğmesine tıkladığında Yardım Mspaint.chm dosyası açılır. Örnek, Yardım dosyasının Mspaint.chm yüklü olmasını gerektirir.

#using <System.dll>
#using <System.Windows.Forms.dll>
#using <System.Drawing.dll>

using namespace System;
using namespace System::Drawing;
using namespace System::ComponentModel;
using namespace System::Windows::Forms;

using System;
using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;

Imports System.Drawing
Imports System.ComponentModel
Imports System.Windows.Forms

// Display a message box with a help button. 
// The Help button opens the Mspaint.chm Help file.
System::Windows::Forms::DialogResult r1 = MessageBox::Show( "Message with Help file.", "Help Caption", MessageBoxButtons::OK, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, (MessageBoxOptions)0, "mspaint.chm" );

// Display a message box with a help button. 
// The Help button opens the Mspaint.chm Help file.
DialogResult r1 = MessageBox.Show ("Message with Help file.", 
                                   "Help Caption", MessageBoxButtons.OK, 
                                   MessageBoxIcon.Question, 
                                   MessageBoxDefaultButton.Button1, 
                                   0, 
                                   "mspaint.chm");

' Display a message box with a help button. 
' The Help button opens the Mspaint.chm Help file.
Dim r1 As DialogResult = MessageBox.Show("Message with Help file.", _
                                   "Help Caption", MessageBoxButtons.OK, _
                                   MessageBoxIcon.Question, _
                                   MessageBoxDefaultButton.Button1, _
                                   0, _
                                   "mspaint.chm")

Açıklamalar

helpFilePath Parametre C:\path\sample.chm veya /folder/file.htm biçiminde olabilir.

Ayrıca bkz.

Şunlara uygulanır

Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, Boolean)

Belirtilen metin, başlık, düğmeler, simge, varsayılan düğme, seçenekler ve Yardım düğmesini içeren bir ileti kutusu görüntüler.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, bool displayHelpButton);

public static System.Windows.Forms.DialogResult Show (string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, bool displayHelpButton);

public static System.Windows.Forms.DialogResult Show (string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, bool displayHelpButton);

static member Show : string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * bool -> System.Windows.Forms.DialogResult

Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, displayHelpButton As Boolean) As DialogResult

Parametreler

text: String

İleti kutusunda görüntülenecek metin.

caption: String

İleti kutusunun başlık çubuğunda görüntülenecek metin.

buttons: MessageBoxButtons

MessageBoxButtons İleti kutusunda hangi düğmelerin görüntüleneceğini belirten değerlerden biri.

icon: MessageBoxIcon

İleti kutusunda hangi simgenin MessageBoxIcon görüntüleneceğini belirten değerlerden biri.

defaultButton: MessageBoxDefaultButton

MessageBoxDefaultButton İleti kutusu için varsayılan düğmeyi belirten değerlerden biri.

options: MessageBoxOptions

displayHelpButton: Boolean

true Yardım düğmesini göstermek için; aksi takdirde , false. Varsayılan değer: false.

Döndürülenler

DialogResult

Değerlerden DialogResult biri.

Özel durumlar

InvalidEnumArgumentException

buttons öğesinin MessageBoxButtonsüyesi değil.

-veya-

icon öğesinin MessageBoxIconüyesi değil.

-veya-

Belirtilen defaultButton öğesinin üyesi MessageBoxDefaultButtondeğil.

InvalidOperationException

Kullanıcı Etkileşimli modunda çalışmayan bir işlemde görüntüleme MessageBox girişiminde bulunuldu. Bu özellik tarafından UserInteractive belirtilir.

ArgumentException

optionshem ServiceNotificationhem de DefaultDesktopOnly belirtildi.

-veya-

buttons geçersiz bir birleşimi belirtti MessageBoxButtons.

Örnekler

Aşağıdaki kod örneği, Yardım düğmesi olan bir ileti kutusunun nasıl gösterilip işlenmeyeceğini Control.HelpRequested ve olaya yanıt olarak özel bir yardım penceresinin nasıl gösterilip gösterilmeyeceğini gösterir.

#using <System.dll>
#using <System.Windows.Forms.dll>
#using <System.Drawing.dll>

using namespace System;
using namespace System::Drawing;
using namespace System::ComponentModel;
using namespace System::Windows::Forms;

using System;
using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;

Imports System.Drawing
Imports System.ComponentModel
Imports System.Windows.Forms

// Display a message box with a Help button. Show a custom Help window
// by handling the HelpRequested event.
System::Windows::Forms::DialogResult AlertMessageWithCustomHelpWindow()
{
   
   // Handle the HelpRequested event for the following message.
   this->HelpRequested += gcnew System::Windows::Forms::HelpEventHandler( this, &Form1::Form1_HelpRequested );
   this->Tag = "Message with Help button.";
   
   // Show a message box with OK and Help buttons.
   System::Windows::Forms::DialogResult r = MessageBox::Show( "Message with Help button.", "Help Caption", MessageBoxButtons::OK, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, (MessageBoxOptions)0, true );
   
   // Remove the HelpRequested event handler to keep the event
   // from being handled for other message boxes.
   this->HelpRequested -= gcnew System::Windows::Forms::HelpEventHandler( this, &Form1::Form1_HelpRequested );
   
   // Return the dialog box result.
   return r;
}

void Form1_HelpRequested( System::Object^ sender, System::Windows::Forms::HelpEventArgs^ hlpevent )
{
   
   // Create a custom Help window in response to the HelpRequested event.
   Form^ helpForm = gcnew Form;
   
   // Set up the form position, size, and title caption.
   helpForm->StartPosition = FormStartPosition::Manual;
   helpForm->Size = System::Drawing::Size( 200, 400 );
   helpForm->DesktopLocation = Point(this->DesktopBounds.X + this->Size.Width,this->DesktopBounds.Top);
   helpForm->Text = "Help Form";
   
   // Create a label to contain the Help text.
   Label^ helpLabel = gcnew Label;
   
   // Add the label to the form and set its text.
   helpForm->Controls->Add( helpLabel );
   helpLabel->Dock = DockStyle::Fill;
   
   // Use the sender parameter to identify the context of the Help request.
   // The parameter must be cast to the Control type to get the Tag property.
   Control^ senderControl = dynamic_cast<Control^>(sender);
   helpLabel->Text = String::Format( "Help information shown in response to user action on the '{0}' message.", dynamic_cast<String^>(senderControl->Tag) );
   
   // Set the Help form to be owned by the main form. This helps
   // to ensure that the Help form is disposed of.
   this->AddOwnedForm( helpForm );
   
   // Show the custom Help window.
   helpForm->Show();
   
   // Indicate that the HelpRequested event is handled.
   hlpevent->Handled = true;
}

// Display a message box with a Help button. Show a custom Help window
// by handling the HelpRequested event.
private DialogResult AlertMessageWithCustomHelpWindow ()
{
    // Handle the HelpRequested event for the following message.
    this.HelpRequested += new System.Windows.Forms.HelpEventHandler (this.Form1_HelpRequested);

    this.Tag = "Message with Help button.";

    // Show a message box with OK and Help buttons.
    DialogResult r = MessageBox.Show ("Message with Help button.", 
                                      "Help Caption", MessageBoxButtons.OK, 
                                      MessageBoxIcon.Question, 
                                      MessageBoxDefaultButton.Button1, 
                                      0, true);

    // Remove the HelpRequested event handler to keep the event
    // from being handled for other message boxes.
    this.HelpRequested -= new System.Windows.Forms.HelpEventHandler (this.Form1_HelpRequested);

    // Return the dialog box result.
    return r;
}

private void Form1_HelpRequested (System.Object sender, System.Windows.Forms.HelpEventArgs hlpevent)
{
    // Create a custom Help window in response to the HelpRequested event.
    Form helpForm = new Form ();

    // Set up the form position, size, and title caption.
    helpForm.StartPosition = FormStartPosition.Manual;
    helpForm.Size = new Size (200, 400);
    helpForm.DesktopLocation = new Point (this.DesktopBounds.X + 
                                          this.Size.Width, 
                                          this.DesktopBounds.Top);
    helpForm.Text = "Help Form";

    // Create a label to contain the Help text.
    Label helpLabel = new Label ();

    // Add the label to the form and set its text.
    helpForm.Controls.Add (helpLabel);
    helpLabel.Dock = DockStyle.Fill;

    // Use the sender parameter to identify the context of the Help request.
    // The parameter must be cast to the Control type to get the Tag property.
    Control senderControl = sender as Control;

    helpLabel.Text = "Help information shown in response to user action on the '" + 
                      (string)senderControl.Tag + "' message.";

    // Set the Help form to be owned by the main form. This helps
    // to ensure that the Help form is disposed of.
    this.AddOwnedForm (helpForm);

    // Show the custom Help window.
    helpForm.Show ();

    // Indicate that the HelpRequested event is handled.
    hlpevent.Handled = true;
}

' Display a message box with a Help button. Show a custom Help window
' by handling the HelpRequested event.
Private Function AlertMessageWithCustomHelpWindow() As DialogResult

    ' Handle the HelpRequested event for the following message.
    AddHandler Me.HelpRequested, AddressOf Me.Form1_HelpRequested

    Me.Tag = "Message with Help button."

    ' Show a message box with OK and Help buttons.
    Dim r As DialogResult = MessageBox.Show("Message with Help button.", _
                                          "Help Caption", MessageBoxButtons.OK, _
                                          MessageBoxIcon.Question, _
                                          MessageBoxDefaultButton.Button1, _
                                          0, True)

    ' Remove the HelpRequested event handler to keep the event
    ' from being handled for other message boxes.
    RemoveHandler Me.HelpRequested, AddressOf Me.Form1_HelpRequested

    ' Return the dialog box result.
    Return r
End Function

Private Sub Form1_HelpRequested(ByVal sender As System.Object, ByVal hlpevent As System.Windows.Forms.HelpEventArgs)

    ' Create a custom Help window in response to the HelpRequested event.
    Dim helpForm As Form = New Form

    ' Set up the form position, size, and title caption.
    With helpForm
        .StartPosition = FormStartPosition.Manual
        .Size = New Size(200, 400)
        .DesktopLocation = New Point(Me.DesktopBounds.X + _
                                     Me.Size.Width, Me.DesktopBounds.Top)
        .Text = "Help Form"
    End With

    ' Create a label to contain the Help text.
    Dim helpLabel As Label = New Label

    ' Add the label to the form and set its text.
    helpForm.Controls.Add(helpLabel)
    helpLabel.Dock = DockStyle.Fill

    ' Use the sender parameter to identify the context of the Help request.
    ' The parameter must be cast to the Control type to get the Tag property.
    Dim senderControl As Control = CType(sender, Control)

    helpLabel.Text = "Help information shown in response to user action on the '" & _
                      CStr(senderControl.Tag) & "' message."

    ' Set the Help form to be owned by the main form. This helps
    ' to ensure that the Help form is disposed of.
    Me.AddOwnedForm(helpForm)

    ' Show the custom Help window.
    helpForm.Show()

    ' Indicate that the HelpRequested event is handled.
    hlpevent.Handled = True
End Sub

Açıklamalar

Kullanıcı Yardım düğmesine tıkladığında, ileti kutusunun (veya etkin formun) sahibi olan form olayı alır HelpRequested . HelpRequested Özel Yardım eylemleri gerçekleştirmek için olayı işleyebilirsiniz.

Ayrıca bkz.

Şunlara uygulanır

Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator)

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, System::String ^ helpFilePath, System::Windows::Forms::HelpNavigator navigator);

public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, System.Windows.Forms.HelpNavigator navigator);

public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window? owner, string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, System.Windows.Forms.HelpNavigator navigator);

static member Show : System.Windows.Forms.IWin32Window * string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * string * System.Windows.Forms.HelpNavigator -> System.Windows.Forms.DialogResult

Public Shared Function Show (owner As IWin32Window, text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, helpFilePath As String, navigator As HelpNavigator) As DialogResult

Parametreler

owner: IWin32Window

Bunun bir IWin32Window uygulaması kalıcı iletişim kutusuna sahip olur.

text: String

İleti kutusunda görüntülenecek metin.

caption: String

İleti kutusunun başlık çubuğunda görüntülenecek metin.

buttons: MessageBoxButtons

MessageBoxButtons İleti kutusunda hangi düğmelerin görüntüleneceğini belirten değerlerden biri.

icon: MessageBoxIcon

İleti kutusunda hangi simgenin MessageBoxIcon görüntüleneceğini belirten değerlerden biri.

defaultButton: MessageBoxDefaultButton

MessageBoxDefaultButton İleti kutusu için varsayılan düğmeyi belirten değerlerden biri.

options: MessageBoxOptions

helpFilePath: String

Kullanıcı Yardım düğmesine tıkladığında görüntülenecek Yardım dosyasının yolu ve adı.

navigator: HelpNavigator

Değerlerden HelpNavigator biri.

Döndürülenler

DialogResult

Değerlerden DialogResult biri.

Özel durumlar

InvalidEnumArgumentException

buttons öğesinin MessageBoxButtonsüyesi değil.

-veya-

icon öğesinin MessageBoxIconüyesi değil.

-veya-

Belirtilen defaultButton öğesinin üyesi MessageBoxDefaultButtondeğil.

InvalidOperationException

Kullanıcı Etkileşimli modunda çalışmayan bir işlemde görüntüleme MessageBox girişiminde bulunuldu. Bu özellik tarafından UserInteractive belirtilir.

ArgumentException

optionshem ServiceNotificationhem de DefaultDesktopOnly belirtildi.

-veya-

buttons geçersiz bir birleşimi belirtti MessageBoxButtons.

Örnekler

Aşağıdaki kod örneği, ana pencerenin üst öğesi olan bir ileti kutusunun nasıl göstereceğini gösterir. İleti kutusunda bir Yardım düğmesi görüntülenir. Kullanıcı Yardım düğmesine tıkladığında, Mspaint.chm Yardım dosyası açılır ve Yardım dizini sekmesi görüntülenir. Örnek, Yardım dosyasının Mspaint.chm yüklü olmasını gerektirir.

#using <System.dll>
#using <System.Windows.Forms.dll>
#using <System.Drawing.dll>

using namespace System;
using namespace System::Drawing;
using namespace System::ComponentModel;
using namespace System::Windows::Forms;

using System;
using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;

Imports System.Drawing
Imports System.ComponentModel
Imports System.Windows.Forms

// Display message box parented to the main form. 
// The Help button opens the Mspaint.chm Help file
// and shows the Help contents on the Index tab.
System::Windows::Forms::DialogResult r4 = MessageBox::Show( this, "Message with Help file and Help navigator.", "Help Caption", MessageBoxButtons::OK, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, (MessageBoxOptions)0, "mspaint.chm", HelpNavigator::Index );

// Display message box parented to the main form. 
// The Help button opens the Mspaint.chm Help file
// and shows the Help contents on the Index tab.
DialogResult r4 = MessageBox.Show (this, 
                                   "Message with Help file and Help navigator.", 
                                   "Help Caption", MessageBoxButtons.OK,
                                   MessageBoxIcon.Question, 
                                   MessageBoxDefaultButton.Button1, 
                                   0, "mspaint.chm", 
                                   HelpNavigator.Index);

' Display message box parented to the main form. 
' The Help button opens the Mspaint.chm Help file
' and shows the Help contents on the Index tab.
Dim r4 As DialogResult = MessageBox.Show(Me, _
                                      "Message with Help file and Help navigator.", _
                                      "Help Caption", MessageBoxButtons.OK, _
                                      MessageBoxIcon.Question, _
                                      MessageBoxDefaultButton.Button1, _
                                      0, "mspaint.chm", _
                                      HelpNavigator.Index)

Açıklamalar

İleti kutusu kalıcı bir iletişim kutusudur; başka bir deyişle, kalıcı formdaki nesneler dışında hiçbir giriş (klavye veya fare tıklaması) gerçekleşemez. Başka bir forma giriş yapılabilmesi için programın kalıcı formu gizlemesi veya kapatması gerekir (genellikle bazı kullanıcı eylemlerine yanıt olarak). parametresini owner , iletişim kutusunun en üst düzey penceresi ve sahibi olarak görev yapacak arabirimi uygulayan IWin32Window belirli bir nesneyi belirtmek için kullanabilirsiniz.

helpFilePath Parametre C:\path\sample.chm veya /folder/file.htm biçiminde olabilir.

Ayrıca bkz.

Şunlara uygulanır

Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton)

Belirtilen nesnenin önünde ve belirtilen metin, başlık, düğmeler, simge ve varsayılan düğmeyle birlikte bir ileti kutusu görüntüler.

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton);

public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton);

public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window? owner, string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton);

static member Show : System.Windows.Forms.IWin32Window * string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton -> System.Windows.Forms.DialogResult

Public Shared Function Show (owner As IWin32Window, text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton) As DialogResult

Parametreler

owner: IWin32Window

Bunun bir IWin32Window uygulaması kalıcı iletişim kutusuna sahip olur.

text: String

İleti kutusunda görüntülenecek metin.

caption: String

İleti kutusunun başlık çubuğunda görüntülenecek metin.

buttons: MessageBoxButtons

MessageBoxButtons İleti kutusunda hangi düğmelerin görüntüleneceğini belirten değerlerden biri.

icon: MessageBoxIcon

İleti kutusunda hangi simgenin MessageBoxIcon görüntüleneceğini belirten değerlerden biri.

defaultButton: MessageBoxDefaultButton

MessageBoxDefaultButton İleti kutusu için varsayılan düğmeyi belirten değerlerden biri.

Döndürülenler

DialogResult

Değerlerden DialogResult biri.

Özel durumlar

InvalidEnumArgumentException

buttons öğesinin MessageBoxButtonsüyesi değil.

-veya-

icon öğesinin MessageBoxIconüyesi değil.

-veya-

defaultButton öğesinin MessageBoxDefaultButtonüyesi değil.

InvalidOperationException

Kullanıcı Etkileşimli modunda çalışmayan bir işlemde görüntüleme MessageBox girişiminde bulunuldu. Bu özellik tarafından UserInteractive belirtilir.

Örnekler

private:
   void validateUserEntry2()
   {
      // Checks the value of the text.
      if ( serverName->Text->Length == 0 )
      {
         // Initializes the variables to pass to the MessageBox::Show method.
         String^ message = "You did not enter a server name. Cancel this operation?";
         String^ caption = "No Server Name Specified";
         MessageBoxButtons buttons = MessageBoxButtons::YesNo;
         System::Windows::Forms::DialogResult result;
         
         // Displays the MessageBox.
         result = MessageBox::Show( this, message, caption, buttons, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, MessageBoxOptions::RightAlign );
         if ( result == ::DialogResult::Yes )
         {
            // Closes the parent form.
            this->Close();
         }
      }
   }


private void validateUserEntry2()
{

    // Checks the value of the text.

    if(serverName.Text.Length == 0)
    {

        // Initializes the variables to pass to the MessageBox.Show method.

        string message = "You did not enter a server name. Cancel this operation?";
        string caption = "No Server Name Specified";
        MessageBoxButtons buttons = MessageBoxButtons.YesNo;
        DialogResult result;

        // Displays the MessageBox.

        result = MessageBox.Show(this, message, caption, buttons,
            MessageBoxIcon.Question, MessageBoxDefaultButton.Button1, 
            MessageBoxOptions.RightAlign);

        if(result == DialogResult.Yes)
        {

            // Closes the parent form.

            this.Close();
        }
    }
}

Private Sub ValidateUserEntry2()


    ' Checks the value of the text.

    If ServerName.Text.Length = 0 Then

        ' Initializes variables to pass to the MessageBox.Show method.

        Dim Message As String = "You did not enter a server name. Cancel this operation?"
        Dim Caption As String = "No Server Name Specified"
        Dim Buttons As Integer = MessageBoxButtons.YesNo

        Dim Result As DialogResult

        'Displays a MessageBox using the Question icon and specifying the No button as the default.

        Result = MessageBox.Show(Me, Message, Caption, MessageBoxButtons.YesNo, _
            MessageBoxIcon.Question, MessageBoxDefaultButton.Button1, MessageBoxOptions.RightAlign)


        ' Gets the result of the MessageBox display.

        If Result = System.Windows.Forms.DialogResult.Yes Then

            ' Closes the parent form.

            Me.Close()

        End If

    End If

End Sub

Açıklamalar

İleti kutusunda en fazla üç düğme olabilir.

Ayrıca bkz.

Şunlara uygulanır

Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon)

Belirtilen nesnenin önünde ve belirtilen metin, başlık, düğmeler ve simgeyle birlikte bir ileti kutusu görüntüler.

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon);

public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon);

public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window? owner, string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon);

static member Show : System.Windows.Forms.IWin32Window * string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon -> System.Windows.Forms.DialogResult

Public Shared Function Show (owner As IWin32Window, text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon) As DialogResult

Parametreler

owner: IWin32Window

Bunun bir IWin32Window uygulaması kalıcı iletişim kutusuna sahip olur.

text: String

İleti kutusunda görüntülenecek metin.

caption: String

İleti kutusunun başlık çubuğunda görüntülenecek metin.

buttons: MessageBoxButtons

MessageBoxButtons İleti kutusunda hangi düğmelerin görüntüleneceğini belirten değerlerden biri.

icon: MessageBoxIcon

İleti kutusunda hangi simgenin MessageBoxIcon görüntüleneceğini belirten değerlerden biri.

Döndürülenler

DialogResult

Değerlerden DialogResult biri.

Özel durumlar

InvalidEnumArgumentException

buttons öğesinin MessageBoxButtonsüyesi değil.

-veya-

icon öğesinin MessageBoxIconüyesi değil.

InvalidOperationException

Kullanıcı Etkileşimli modunda çalışmayan bir işlemde görüntüleme MessageBox girişiminde bulunuldu. Bu özellik tarafından UserInteractive belirtilir.

Örnekler

private:
   void validateUserEntry4()
   {
      // Checks the value of the text.
      if ( serverName->Text->Length == 0 )
      {
         // Initializes the variables to pass to the MessageBox::Show method.
         String^ message = "You did not enter a server name. Cancel this operation?";
         String^ caption = "No Server Name Specified";
         MessageBoxButtons buttons = MessageBoxButtons::YesNo;
         System::Windows::Forms::DialogResult result;

         // Displays the MessageBox.
         result = MessageBox::Show( this, message, caption, buttons, MessageBoxIcon::Question );
         if ( result == ::DialogResult::Yes )
         {
            // Closes the parent form.
            this->Close();
         }
      }
   }

private void validateUserEntry4()
{

    // Checks the value of the text.

    if(serverName.Text.Length == 0)
    {

        // Initializes the variables to pass to the MessageBox.Show method.

        string message = "You did not enter a server name. Cancel this operation?";
        string caption = "No Server Name Specified";
        MessageBoxButtons buttons = MessageBoxButtons.YesNo;
        DialogResult result;

        // Displays the MessageBox.

        result = MessageBox.Show(this, message, caption, buttons,
            MessageBoxIcon.Question);

        if(result == DialogResult.Yes)
        {

            // Closes the parent form.

            this.Close();
        }
    }
}

Private Sub ValidateUserEntry4()

    ' Checks the value of the text.

    If ServerName.Text.Length = 0 Then

        ' Initializes variables to pass to the MessageBox.Show method.

        Dim Message As String = "You did not enter a server name. Cancel this operation?"
        Dim Caption As String = "No Server Name Specified"
        Dim Buttons As Integer = MessageBoxButtons.YesNo

        Dim Result As DialogResult

        'Displays a MessageBox using the Question icon and specifying the No button as the default.

        Result = MessageBox.Show(Me, Message, Caption, MessageBoxButtons.YesNo, MessageBoxIcon.Question)

        ' Gets the result of the MessageBox display.

        If Result = System.Windows.Forms.DialogResult.Yes Then

            ' Closes the parent form.

            Me.Close()

        End If

    End If

End Sub

Açıklamalar

İleti kutusunda en fazla üç düğme olabilir.

Ayrıca bkz.

Şunlara uygulanır

Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton)

Belirtilen metin, başlık, düğmeler, simge ve varsayılan düğmeyi içeren bir ileti kutusu görüntüler.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton);

public static System.Windows.Forms.DialogResult Show (string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton);

public static System.Windows.Forms.DialogResult Show (string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton);

static member Show : string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton -> System.Windows.Forms.DialogResult

Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton) As DialogResult

Parametreler

text: String

İleti kutusunda görüntülenecek metin.

caption: String

İleti kutusunun başlık çubuğunda görüntülenecek metin.

buttons: MessageBoxButtons

MessageBoxButtons İleti kutusunda hangi düğmelerin görüntüleneceğini belirten değerlerden biri.

icon: MessageBoxIcon

İleti kutusunda hangi simgenin MessageBoxIcon görüntüleneceğini belirten değerlerden biri.

defaultButton: MessageBoxDefaultButton

MessageBoxDefaultButton İleti kutusu için varsayılan düğmeyi belirten değerlerden biri.

Döndürülenler

DialogResult

Değerlerden DialogResult biri.

Özel durumlar

InvalidEnumArgumentException

buttons öğesinin MessageBoxButtonsüyesi değil.

-veya-

icon öğesinin MessageBoxIconüyesi değil.

-veya-

defaultButton öğesinin MessageBoxDefaultButtonüyesi değil.

InvalidOperationException

Kullanıcı Etkileşimli modunda çalışmayan bir işlemde görüntüleme MessageBox girişiminde bulunuldu. Bu özellik tarafından UserInteractive belirtilir.

Örnekler

Aşağıdaki kod örneği, öğesinin bu aşırı yüklemesi Showtarafından desteklenen seçeneklerle nasıl görüntüleneceğini MessageBox gösterir. dize değişkeninin ServerNameboş olduğunu doğruladıktan sonra örnekte soru kutusu simgesiyle birlikte bir MessageBox görüntülenir ve kullanıcıya işlemi iptal etme seçeneği sağlanır. Yöntemin Show dönüş değeri olarak değerlendirilirse Yes, öğesini görüntüleyen MessageBox form kapatılır.

private:
   void validateUserEntry3()
   {
      // Checks the value of the text.
      if ( serverName->Text->Length == 0 )
      {
         // Initializes the variables to pass to the MessageBox::Show method.
         String^ message = "You did not enter a server name. Cancel this operation?";
         String^ caption = "No Server Name Specified";
         MessageBoxButtons buttons = MessageBoxButtons::YesNo;
         System::Windows::Forms::DialogResult result;

         // Displays the MessageBox.
         result = MessageBox::Show( this, message, caption, buttons, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1 );
         if ( result == ::DialogResult::Yes )
         {
            // Closes the parent form.
            this->Close();
         }
      }
   }

private void validateUserEntry3()
{

    // Checks the value of the text.

    if(serverName.Text.Length == 0)
    {

        // Initializes the variables to pass to the MessageBox.Show method.

        string message = "You did not enter a server name. Cancel this operation?";
        string caption = "No Server Name Specified";
        MessageBoxButtons buttons = MessageBoxButtons.YesNo;
        DialogResult result;

        // Displays the MessageBox.

        result = MessageBox.Show(this, message, caption, buttons,
        MessageBoxIcon.Question, MessageBoxDefaultButton.Button1);

        if(result == DialogResult.Yes)
        {

            // Closes the parent form.

            this.Close();
        }
    }
}

Private Sub ValidateUserEntry3()

    ' Checks the value of the text.

    If ServerName.Text.Length = 0 Then

        ' Initializes variables to pass to the MessageBox.Show method.

        Dim Message As String = "You did not enter a server name. Cancel this operation?"
        Dim Caption As String = "No Server Name Specified"
        Dim Buttons As Integer = MessageBoxButtons.YesNo

        Dim Result As DialogResult

        'Displays a MessageBox using the Question icon and specifying the No button as the default.

        Result = MessageBox.Show(Me, Message, Caption, MessageBoxButtons.YesNo, MessageBoxIcon.Question, _
            MessageBoxDefaultButton.Button1)

        ' Gets the result of the MessageBox display.

        If Result = System.Windows.Forms.DialogResult.Yes Then

            ' Closes the parent form.

            Me.Close()

        End If

    End If
End Sub

Açıklamalar

İleti kutusunda en fazla üç düğme olabilir.

Ayrıca bkz.

Şunlara uygulanır

Show(IWin32Window, String, String, MessageBoxButtons)

Belirtilen nesnenin önünde ve belirtilen metin, başlık ve düğmelerle bir ileti kutusu görüntüler.

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons);

public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text, string caption, System.Windows.Forms.MessageBoxButtons buttons);

public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window? owner, string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons);

static member Show : System.Windows.Forms.IWin32Window * string * string * System.Windows.Forms.MessageBoxButtons -> System.Windows.Forms.DialogResult

Public Shared Function Show (owner As IWin32Window, text As String, caption As String, buttons As MessageBoxButtons) As DialogResult

Parametreler

owner: IWin32Window

Bunun bir IWin32Window uygulaması kalıcı iletişim kutusuna sahip olur.

text: String

İleti kutusunda görüntülenecek metin.

caption: String

İleti kutusunun başlık çubuğunda görüntülenecek metin.

buttons: MessageBoxButtons

MessageBoxButtons İleti kutusunda hangi düğmelerin görüntüleneceğini belirten değerlerden biri.

Döndürülenler

DialogResult

Değerlerden DialogResult biri.

Özel durumlar

InvalidEnumArgumentException

buttons öğesinin MessageBoxButtonsüyesi değil.

InvalidOperationException

Kullanıcı Etkileşimli modunda çalışmayan bir işlemde görüntüleme MessageBox girişiminde bulunuldu. Bu özellik tarafından UserInteractive belirtilir.

Örnekler

private:
   void validateUserEntry5()
   {
      // Checks the value of the text.
      if ( serverName->Text->Length == 0 )
      {
         // Initializes the variables to pass to the MessageBox::Show method.
         String^ message = "You did not enter a server name. Cancel this operation?";
         String^ caption = "No Server Name Specified";
         MessageBoxButtons buttons = MessageBoxButtons::YesNo;
         System::Windows::Forms::DialogResult result;

         // Displays the MessageBox.
         result = MessageBox::Show( this, message, caption, buttons );
         if ( result == ::DialogResult::Yes )
         {
            // Closes the parent form.
            this->Close();
         }
      }
   }

private void validateUserEntry5()
{

    // Checks the value of the text.

    if(serverName.Text.Length == 0)
    {

        // Initializes the variables to pass to the MessageBox.Show method.

        string message = "You did not enter a server name. Cancel this operation?";
        string caption = "No Server Name Specified";
        MessageBoxButtons buttons = MessageBoxButtons.YesNo;
        DialogResult result;

        // Displays the MessageBox.

        result = MessageBox.Show(this, message, caption, buttons);

        if(result == DialogResult.Yes)
        {

            // Closes the parent form.

            this.Close();
        }
    }
}

Private Sub ValidateUserEntry5()

    ' Checks the value of the text.

    If ServerName.Text.Length = 0 Then

        ' Initializes variables to pass to the MessageBox.Show method.

        Dim Message As String = "You did not enter a server name. Cancel this operation?"
        Dim Caption As String = "No Server Name Specified"
        Dim Buttons As Integer = MessageBoxButtons.YesNo

        Dim Result As DialogResult

        'Displays a MessageBox using the Question icon and specifying the No button as the default.

        Result = MessageBox.Show(Me, Message, Caption, MessageBoxButtons.YesNo)

        ' Gets the result of the MessageBox display.

        If Result = System.Windows.Forms.DialogResult.Yes Then

            ' Closes the parent form.

            Me.Close()

        End If

    End If

End Sub

Açıklamalar

İleti kutusunda en fazla üç düğme olabilir.

Ayrıca bkz.

MessageBoxButtons

Şunlara uygulanır

Show(String, String, MessageBoxButtons, MessageBoxIcon)

Belirtilen metin, başlık, düğmeler ve simge içeren bir ileti kutusu görüntüler.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon);

public static System.Windows.Forms.DialogResult Show (string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon);

public static System.Windows.Forms.DialogResult Show (string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon);

static member Show : string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon -> System.Windows.Forms.DialogResult

Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon) As DialogResult

Parametreler

text: String

İleti kutusunda görüntülenecek metin.

caption: String

İleti kutusunun başlık çubuğunda görüntülenecek metin.

buttons: MessageBoxButtons

MessageBoxButtons İleti kutusunda hangi düğmelerin görüntüleneceğini belirten değerlerden biri.

icon: MessageBoxIcon

İleti kutusunda hangi simgenin MessageBoxIcon görüntüleneceğini belirten değerlerden biri.

Döndürülenler

DialogResult

Değerlerden DialogResult biri.

Özel durumlar

InvalidEnumArgumentException

Belirtilen buttons parametre öğesinin MessageBoxButtonsüyesi değil.

-veya-

Belirtilen icon parametre öğesinin MessageBoxIconüyesi değil.

InvalidOperationException

Kullanıcı Etkileşimli modunda çalışmayan bir işlemde görüntüleme MessageBox girişiminde bulunuldu. Bu özellik tarafından UserInteractive belirtilir.

Örnekler

Aşağıdaki kod örneği, olayı işlerken ComboBox.DropDown yöntemlerden birini Show gösterir. Örneği çalıştırmak için aşağıdaki kodu bir forma yapıştırın ve formun InitializeComboBox oluşturucusundan veya Load yönteminden yöntemini çağırın.

internal:
   // Declare ComboBox1
   System::Windows::Forms::ComboBox^ ComboBox1;

private:
   // Initialize ComboBox1.
   void InitializeComboBox()
   {
      this->ComboBox1 = gcnew ComboBox;
      this->ComboBox1->Location = System::Drawing::Point( 128, 48 );
      this->ComboBox1->Name = "ComboBox1";
      this->ComboBox1->Size = System::Drawing::Size( 100, 21 );
      this->ComboBox1->TabIndex = 0;
      this->ComboBox1->Text = "Typical";
      array<String^>^ installs = {"Typical","Compact","Custom"};
      ComboBox1->Items->AddRange( installs );
      this->Controls->Add( this->ComboBox1 );
      
      // Hook up the event handler.
      this->ComboBox1->DropDown += gcnew System::EventHandler(
         this, &Form1::ComboBox1_DropDown );
   }

   // Handles the ComboBox1 DropDown event. If the user expands the  
   // drop-down box, a message box will appear, recommending the
   // typical installation.
   void ComboBox1_DropDown( Object^ sender, System::EventArgs^ e )
   {
      MessageBox::Show( "Typical installation is strongly recommended.",
         "Install information", MessageBoxButtons::OK,
         MessageBoxIcon::Information );
   }


// Declare ComboBox1.
internal System.Windows.Forms.ComboBox ComboBox1;

// Initialize ComboBox1.
private void InitializeComboBox()
{
    this.ComboBox1 = new ComboBox();
    this.ComboBox1.Location = new System.Drawing.Point(128, 48);
    this.ComboBox1.Name = "ComboBox1";
    this.ComboBox1.Size = new System.Drawing.Size(100, 21);
    this.ComboBox1.TabIndex = 0;
    this.ComboBox1.Text	= "Typical";
    string[] installs = new string[]{"Typical", "Compact", "Custom"};
    ComboBox1.Items.AddRange(installs);
    this.Controls.Add(this.ComboBox1);
    
    // Hook up the event handler.
    this.ComboBox1.DropDown +=  
        new System.EventHandler(ComboBox1_DropDown);
}

// Handles the ComboBox1 DropDown event. If the user expands the  
// drop-down box, a message box will appear, recommending the
// typical installation.
private void ComboBox1_DropDown(object sender, System.EventArgs e)
{
    MessageBox.Show("Typical installation is strongly recommended.", 
    "Install information", MessageBoxButtons.OK, 
        MessageBoxIcon.Information);
}


' Declare ComboBox1.
Friend WithEvents ComboBox1 As System.Windows.Forms.ComboBox

' Initialize ComboBox1.
Private Sub InitializeComboBox()
    Me.ComboBox1 = New ComboBox
    Me.ComboBox1.Location = New System.Drawing.Point(128, 48)
    Me.ComboBox1.Name = "ComboBox1"
    Me.ComboBox1.Size = New System.Drawing.Size(100, 21)
    Me.ComboBox1.TabIndex = 0
    Me.ComboBox1.Text = "Typical"
    Dim installs() As String = New String() _
        {"Typical", "Compact", "Custom"}
    ComboBox1.Items.AddRange(installs)
    Me.Controls.Add(Me.ComboBox1)
End Sub

' Handles the ComboBox1 DropDown event. If the user expands the  
' drop-down box, a message box will appear, recommending the
' typical installation.
Private Sub ComboBox1_DropDown _ 
    (ByVal sender As Object, ByVal e As System.EventArgs) _ 
    Handles ComboBox1.DropDown
    MessageBox.Show("Typical installation is strongly recommended.", _
    "Install information", MessageBoxButtons.OK, MessageBoxIcon.Information)
End Sub

Açıklamalar

İleti kutusunda en fazla üç düğme olabilir.

Ayrıca bkz.

Şunlara uygulanır

Show(IWin32Window, String, String)

Belirtilen nesnenin önünde, belirtilen metin ve başlık içeren bir ileti kutusu görüntüler.

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text, System::String ^ caption);

public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text, string caption);

public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window? owner, string? text, string? caption);

static member Show : System.Windows.Forms.IWin32Window * string * string -> System.Windows.Forms.DialogResult

Public Shared Function Show (owner As IWin32Window, text As String, caption As String) As DialogResult

Parametreler

owner: IWin32Window

Bunun bir IWin32Window uygulaması kalıcı iletişim kutusuna sahip olur.

text: String

İleti kutusunda görüntülenecek metin.

caption: String

İleti kutusunun başlık çubuğunda görüntülenecek metin.

Döndürülenler

DialogResult

Değerlerden DialogResult biri.

Açıklamalar

Varsayılan olarak, ileti kutusunda Tamam düğmesi görüntülenir.

Şunlara uygulanır

Show(String, String, MessageBoxButtons)

Belirtilen metin, başlık ve düğmeler içeren bir ileti kutusu görüntüler.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons);

public static System.Windows.Forms.DialogResult Show (string text, string caption, System.Windows.Forms.MessageBoxButtons buttons);

public static System.Windows.Forms.DialogResult Show (string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons);

static member Show : string * string * System.Windows.Forms.MessageBoxButtons -> System.Windows.Forms.DialogResult

Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons) As DialogResult

Parametreler

text: String

İleti kutusunda görüntülenecek metin.

caption: String

İleti kutusunun başlık çubuğunda görüntülenecek metin.

buttons: MessageBoxButtons

MessageBoxButtons İleti kutusunda hangi düğmelerin görüntüleneceğini belirten değerlerden biri.

Döndürülenler

DialogResult

Değerlerden DialogResult biri.

Özel durumlar

InvalidEnumArgumentException

Belirtilen buttons parametre öğesinin MessageBoxButtonsüyesi değil.

InvalidOperationException

Kullanıcı Etkileşimli modunda çalışmayan bir işlemde görüntüleme MessageBox girişiminde bulunuldu. Bu özellik tarafından UserInteractive belirtilir.

Örnekler

private:
   void validateUserEntry()
   {
      // Checks the value of the text.
      if ( serverName->Text->Length == 0 )
      {
         // Initializes the variables to pass to the MessageBox::Show method.
         String^ message = "You did not enter a server name. Cancel this operation?";
         String^ caption = "No Server Name Specified";
         MessageBoxButtons buttons = MessageBoxButtons::YesNo;
         System::Windows::Forms::DialogResult result;

         // Displays the MessageBox.
         result = MessageBox::Show( this, message, caption, buttons );
         if ( result == ::DialogResult::Yes )
         {
            // Closes the parent form.
            this->Close();
         }
      }
   }

private void validateUserEntry()
{
    // Checks the value of the text.
    if(serverName.Text.Length == 0)
    {
        // Initializes the variables to pass to the MessageBox.Show method.
        string message = "You did not enter a server name. Cancel this operation?";
     string caption = "Error Detected in Input";
        MessageBoxButtons buttons = MessageBoxButtons.YesNo;
        DialogResult result;

        // Displays the MessageBox.
        result = MessageBox.Show(message, caption, buttons);
        if (result == System.Windows.Forms.DialogResult.Yes)
        {
            // Closes the parent form.
            this.Close();
        }
    }
}

Private Sub ValidateUserEntry()
    ' Checks the value of the text.
    If ServerName.Text.Length = 0 Then

        ' Initializes variables to pass to the MessageBox.Show method.
        Dim Message As String = "You did not enter a server name. Cancel this operation?"
        Dim Caption As String = "Error Detected in Input"
        Dim Buttons As MessageBoxButtons = MessageBoxButtons.YesNo

        Dim Result As DialogResult

        'Displays the MessageBox
        Result = MessageBox.Show(Message, Caption, Buttons)

        ' Gets the result of the MessageBox display.
        If Result = System.Windows.Forms.DialogResult.Yes Then
            ' Closes the parent form.
            Me.Close()
        End If
    End If
End Sub

Açıklamalar

İleti kutusunda en fazla üç düğme olabilir.

Ayrıca bkz.

MessageBoxButtons

Şunlara uygulanır

Show(IWin32Window, String)

Belirtilen nesnenin önünde ve belirtilen metinle birlikte bir ileti kutusu görüntüler.

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text);

public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text);

public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window? owner, string? text);

static member Show : System.Windows.Forms.IWin32Window * string -> System.Windows.Forms.DialogResult

Public Shared Function Show (owner As IWin32Window, text As String) As DialogResult

Parametreler

owner: IWin32Window

Bunun bir IWin32Window uygulaması kalıcı iletişim kutusuna sahip olur.

text: String

İleti kutusunda görüntülenecek metin.

Döndürülenler

DialogResult

Değerlerden DialogResult biri.

Açıklamalar

Varsayılan olarak, ileti kutusunda Tamam düğmesi görüntülenir. İleti kutusu başlıkta bir başlık içermiyor.

Şunlara uygulanır

Show(String, String)

Belirtilen metin ve başlık içeren bir ileti kutusu görüntüler.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption);

public static System.Windows.Forms.DialogResult Show (string text, string caption);

public static System.Windows.Forms.DialogResult Show (string? text, string? caption);

static member Show : string * string -> System.Windows.Forms.DialogResult

Public Shared Function Show (text As String, caption As String) As DialogResult

Parametreler

text: String

İleti kutusunda görüntülenecek metin.

caption: String

İleti kutusunun başlık çubuğunda görüntülenecek metin.

Döndürülenler

DialogResult

Değerlerden DialogResult biri.

Açıklamalar

Varsayılan olarak, ileti kutusunda Tamam düğmesi görüntülenir.

Şunlara uygulanır

Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions)

Belirtilen metin, başlık, düğmeler, simge, varsayılan düğme ve seçenekleri içeren bir ileti kutusu görüntüler.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options);

public static System.Windows.Forms.DialogResult Show (string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options);

public static System.Windows.Forms.DialogResult Show (string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options);

static member Show : string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions -> System.Windows.Forms.DialogResult

Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions) As DialogResult

Parametreler

text: String

İleti kutusunda görüntülenecek metin.

caption: String

İleti kutusunun başlık çubuğunda görüntülenecek metin.

buttons: MessageBoxButtons

MessageBoxButtons İleti kutusunda hangi düğmelerin görüntüleneceğini belirten değerlerden biri.

icon: MessageBoxIcon

İleti kutusunda hangi simgenin MessageBoxIcon görüntüleneceğini belirten değerlerden biri.

defaultButton: MessageBoxDefaultButton

MessageBoxDefaultButton İleti kutusu için varsayılan düğmeyi belirten değerlerden biri.

options: MessageBoxOptions

Döndürülenler

DialogResult

Değerlerden DialogResult biri.

Özel durumlar

InvalidEnumArgumentException

buttons öğesinin MessageBoxButtonsüyesi değil.

-veya-

icon öğesinin MessageBoxIconüyesi değil.

-veya-

Belirtilen defaultButton öğesinin üyesi MessageBoxDefaultButtondeğil.

InvalidOperationException

Kullanıcı Etkileşimli modunda çalışmayan bir işlemde görüntüleme MessageBox girişiminde bulunuldu. Bu özellik tarafından UserInteractive belirtilir.

ArgumentException

optionshem ServiceNotificationhem de DefaultDesktopOnly belirtildi.

-veya-

buttons geçersiz bir birleşimi belirtti MessageBoxButtons.

Örnekler

Aşağıdaki kod örneği, öğesinin bu aşırı yüklemesi Showtarafından desteklenen seçeneklerle nasıl görüntüleneceğini MessageBox gösterir. dize değişkeninin ServerNameboş olduğunu doğruladıktan sonra örnekte soru kutusu simgesiyle birlikte bir MessageBox görüntülenir ve kullanıcıya işlemi iptal etme seçeneği sağlanır. Örnekte, metni iletişim kutusunun sağ kenarına hizalamak için numaralandırmanın üyesi MessageBoxOptions kullanılırRightAlign. Yöntemin Show dönüş değeri olarak değerlendirilirse Yes, öğesini görüntüleyen MessageBox form kapatılır.

private:
   void validateUserEntry2()
   {
      // Checks the value of the text.
      if ( serverName->Text->Length == 0 )
      {
         // Initializes the variables to pass to the MessageBox::Show method.
         String^ message = "You did not enter a server name. Cancel this operation?";
         String^ caption = "No Server Name Specified";
         MessageBoxButtons buttons = MessageBoxButtons::YesNo;
         System::Windows::Forms::DialogResult result;
         
         // Displays the MessageBox.
         result = MessageBox::Show( this, message, caption, buttons, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, MessageBoxOptions::RightAlign );
         if ( result == ::DialogResult::Yes )
         {
            // Closes the parent form.
            this->Close();
         }
      }
   }


private void validateUserEntry2()
{

    // Checks the value of the text.

    if(serverName.Text.Length == 0)
    {

        // Initializes the variables to pass to the MessageBox.Show method.

        string message = "You did not enter a server name. Cancel this operation?";
        string caption = "No Server Name Specified";
        MessageBoxButtons buttons = MessageBoxButtons.YesNo;
        DialogResult result;

        // Displays the MessageBox.

        result = MessageBox.Show(this, message, caption, buttons,
            MessageBoxIcon.Question, MessageBoxDefaultButton.Button1, 
            MessageBoxOptions.RightAlign);

        if(result == DialogResult.Yes)
        {

            // Closes the parent form.

            this.Close();
        }
    }
}

Private Sub ValidateUserEntry2()


    ' Checks the value of the text.

    If ServerName.Text.Length = 0 Then

        ' Initializes variables to pass to the MessageBox.Show method.

        Dim Message As String = "You did not enter a server name. Cancel this operation?"
        Dim Caption As String = "No Server Name Specified"
        Dim Buttons As Integer = MessageBoxButtons.YesNo

        Dim Result As DialogResult

        'Displays a MessageBox using the Question icon and specifying the No button as the default.

        Result = MessageBox.Show(Me, Message, Caption, MessageBoxButtons.YesNo, _
            MessageBoxIcon.Question, MessageBoxDefaultButton.Button1, MessageBoxOptions.RightAlign)


        ' Gets the result of the MessageBox display.

        If Result = System.Windows.Forms.DialogResult.Yes Then

            ' Closes the parent form.

            Me.Close()

        End If

    End If

End Sub

Açıklamalar

İleti kutusunda en fazla üç düğme olabilir.

Ayrıca bkz.

Şunlara uygulanır

Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator, Object)

Belirtilen Yardım dosyasınıHelpNavigator, ve Yardım konusunu kullanarak, belirtilen metin, başlık, düğmeler, simge, varsayılan düğme, seçenekler ve Yardım düğmesi içeren bir ileti kutusu görüntüler.

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, System::String ^ helpFilePath, System::Windows::Forms::HelpNavigator navigator, System::Object ^ param);

public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, System.Windows.Forms.HelpNavigator navigator, object param);

public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window? owner, string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, System.Windows.Forms.HelpNavigator navigator, object? param);

static member Show : System.Windows.Forms.IWin32Window * string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * string * System.Windows.Forms.HelpNavigator * obj -> System.Windows.Forms.DialogResult

Public Shared Function Show (owner As IWin32Window, text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, helpFilePath As String, navigator As HelpNavigator, param As Object) As DialogResult

Parametreler

owner: IWin32Window

Bunun bir IWin32Window uygulaması kalıcı iletişim kutusuna sahip olur.

text: String

İleti kutusunda görüntülenecek metin.

caption: String

İleti kutusunun başlık çubuğunda görüntülenecek metin.

buttons: MessageBoxButtons

MessageBoxButtons İleti kutusunda hangi düğmelerin görüntüleneceğini belirten değerlerden biri.

icon: MessageBoxIcon

İleti kutusunda hangi simgenin MessageBoxIcon görüntüleneceğini belirten değerlerden biri.

defaultButton: MessageBoxDefaultButton

MessageBoxDefaultButton İleti kutusu için varsayılan düğmeyi belirten değerlerden biri.

options: MessageBoxOptions

helpFilePath: String

Kullanıcı Yardım düğmesine tıkladığında görüntülenecek Yardım dosyasının yolu ve adı.

navigator: HelpNavigator

Değerlerden HelpNavigator biri.

param: Object

Kullanıcı Yardım düğmesine tıkladığında görüntülenecek Yardım konusunun sayısal kimliği.

Döndürülenler

DialogResult

Değerlerden DialogResult biri.

Özel durumlar

InvalidEnumArgumentException

buttons öğesinin MessageBoxButtonsüyesi değil.

-veya-

icon öğesinin MessageBoxIconüyesi değil.

-veya-

Belirtilen defaultButton öğesinin üyesi MessageBoxDefaultButtondeğil.

InvalidOperationException

Kullanıcı Etkileşimli modunda çalışmayan bir işlemde görüntüleme MessageBox girişiminde bulunuldu. Bu özellik tarafından UserInteractive belirtilir.

ArgumentException

optionshem ServiceNotificationhem de DefaultDesktopOnly belirtildi.

-veya-

buttons geçersiz bir birleşimi belirtti MessageBoxButtons.

Örnekler

Aşağıdaki kod örneği, ana pencerenin üst öğesi olan bir ileti kutusunun nasıl göstereceğini gösterir. İleti kutusunda bir Yardım düğmesi görüntülenir. Kullanıcı Yardım düğmesine tıkladığında, Mspaint.chm Yardım dosyası açılır ve Yardım dizini sekmesi ve anahtar sözcük tarafından ovals tanımlanan konu görüntülenir. Örnek, Yardım dosyasının Mspaint.chm yüklü olmasını gerektirir.

#using <System.dll>
#using <System.Windows.Forms.dll>
#using <System.Drawing.dll>

using namespace System;
using namespace System::Drawing;
using namespace System::ComponentModel;
using namespace System::Windows::Forms;

using System;
using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;

Imports System.Drawing
Imports System.ComponentModel
Imports System.Windows.Forms

// Display message box parented to the main form. 
// The Help button opens the Mspaint.chm Help file, 
// shows index with the "ovals" keyword selected, and displays the
// associated topic.
System::Windows::Forms::DialogResult r6 = MessageBox::Show( this, "Message with Help file and Help navigator with additional parameter.", "Help Caption", MessageBoxButtons::OK, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, (MessageBoxOptions)0, "mspaint.chm", HelpNavigator::KeywordIndex, "ovals" );

// Display message box parented to the main form. 
// The Help button opens the Mspaint.chm Help file, 
// shows index with the "ovals" keyword selected, and displays the
// associated topic.
DialogResult r6 = MessageBox.Show (this, 
                                   "Message with Help file and Help navigator with additional parameter.", 
                                   "Help Caption", MessageBoxButtons.OK, 
                                   MessageBoxIcon.Question, 
                                   MessageBoxDefaultButton.Button1, 
                                   0, "mspaint.chm", 
                                   HelpNavigator.KeywordIndex, "ovals");

' Display message box parented to the main form. 
' The Help button opens the Mspaint.chm Help file, 
' shows index with the "ovals" keyword selected, and displays the
' associated topic.
Dim r6 As DialogResult = MessageBox.Show(Me, _
                                   "Message with Help file and Help navigator with additional parameter.", _
                                   "Help Caption", MessageBoxButtons.OK, _
                                   MessageBoxIcon.Question, _
                                   MessageBoxDefaultButton.Button1, _
                                   0, "mspaint.chm", _
                                   HelpNavigator.KeywordIndex, "ovals")

Açıklamalar

komutunda daha fazla iyileştirme Topic sağlamak için komutunu param kullanabilirsiniz. parametresinde navigator belirtilen değer , Indexveya FindiseTableOfContents, bu değer olmalıdırnull. navigator parametresi başvuruda bulunursaTopic, bu değer görüntülenecek konunun sayısal değerini içeren bir nesneye başvurmalıdır.

helpFilePath Parametre C:\path\sample.chm veya /folder/file.htm biçiminde olabilir.

Ayrıca bkz.

Şunlara uygulanır

Aracılığıyla paylaş

MessageBox.Show Yöntem

Tanım

Aşırı Yüklemeler

Show(String)

Parametreler

Döndürülenler

Örnekler

Açıklamalar

Şunlara uygulanır

Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, String)

Parametreler

Döndürülenler

Özel durumlar

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator, Object)

Parametreler

Döndürülenler

Özel durumlar

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String)

Parametreler

Döndürülenler

Özel durumlar

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator)

Parametreler

Döndürülenler

Özel durumlar

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, String)

Parametreler

Döndürülenler

Özel durumlar

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions)

Parametreler

Döndürülenler

Özel durumlar

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String)

Parametreler

Döndürülenler

Özel durumlar

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, Boolean)

Parametreler

Döndürülenler

Özel durumlar

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator)

Parametreler

Döndürülenler

Özel durumlar

Örnekler

Açıklamalar