MessageBox.Show("Hello World!");
شما همچنین می توانید به راحتی و با استفاده از یکی دیگر از سربارگذاریهای متد ()Show یک عنوان برای جعبه پیامتان بگذارید.
MessageBox.Show("Hello World!", "A Message");
اگر نخواهید از دکمه OK پیشفرض جعبه متن استفاده کنید می توانید با استفاده از System.Windows.Forms.MessageBoxButtons آنرا تغییر دهید.
MessageBox.Show("Hello World!", "A Message", MessageBoxButtons.OKCancel);
جدول زیر اعضای MessageBoxButtons را نشان می دهد :
عضو | دکمه هایی که نمایش می دهد |
AbortRetryIgnore | Abort, Retry, Ignore |
OK | OK |
OKCancel | OK, Cancel |
RetryCancel | Retry, Cancel |
YesNo | Yes, No |
YesNoCancel | Yes, No, Cancel |
متد ()Show یک مقدار را از System.Windows.Forms.DialogResult بر می گرداند. تشخیص اینکه چه دکمه ای توسط شما در جعبه متن فشار داده می شود مفید است. به عنوان مثال اگر بر روی دکمه Yes در جعبه پیام کلیک کنید، متد ()Show مقدار DialogResult.Yes را بر می گرداند.
DialogResult result; result = MessageBox.Show("What is your choice?"); if (result == DialogResult.Yes) { //You pressed the Yes button } if (result == DialogResult.No) { //You pressed the No button }
لطفا به این نکته توجه کنید که کلاس Form یک خاصیت DialogResult دارد و آن را با System.Windows.Forms.DialogResult اشتباه نگیرید. می توان به جعبه پیام برای نشان دادن معنی و مفهوم آن یک آیکون اضافه کرد. می توانید این کار را با استفاده از نوع شمارشی MessageBoxIcon انجام دهید.
MessageBox.Show("Hello World!", "A Message", MessageBoxButtons.OKCancel, MessageBoxIcon.Information);
در جدول زیر انواع آیکونها و کاربرد آنها در جعبه پیام نشان داده شده است :
آیکون | عضو | استفاده |
Asterisk Information |
برای نشان دادن اطلاعات به کاربر | |
Error Hand Stop |
برای نشان دادن یک پیغام خطا | |
Exclamation Warning |
برای نشان دادن یک هشدار | |
Question | برای سوال کردن از کاربر |
اگر بخواهید که جعبه متن هیچ گونه آیکونی نداشته باشد می توانید از MessageBoxIcon.None استفاده کنید. نوع شمارشی MessageBoxDefaultButton دکمه پیشفرضی را که هنگام فشرده شدن دکمه Enter باید عمل کند را تعیین می کند و فقط دارای سه عضو است Button2، Button1 و Button3. به عنوان مثال در جعبه متنی که دارای دکمه های OK و Cancel است استفاده از MessageBoxDefaultButton.Button1 باعث می شود که دکمه OK به صورت پیشفرض درآید. یعنی هنگامی که جعبه متن نشان داده شد با زدن دکمه Enter، دکمه OK فشرده می شود :
MessageBox.Show( "Hello World!", "A Message", MessageBoxButtons.OKCancel, MessageBoxIcon.Information, MessageBoxDefaultButton.Button1 );
همانطور که در کد بالا مشاهده می کنید رنگ دکمه OK نسبت به دکمه Cancel متفاوت است که نشان دهنده پیشفرض بودن این دکمه است. متد ()Show دارای پارامتر دیگری از نوع شمارشی MessageBoxOptions است که دارای مقادیر مختلفی است. یکی از این مقادیر RtlReading بوده که از آن برای راست به چپ کردن پیغام استفاده می شود :
MessageBox.Show( "Hello World!", "A Message", MessageBoxButtons.OKCancel, MessageBoxIcon.Information, MessageBoxDefaultButton.Button1, MessageBoxOptions.RtlReading );