سرخط خبرها
خانه » C# » کلاس MessageBox

کلاس MessageBox

System.Windows.Forms.MessageBox یک کلاس استاتیک است که از آن برای نشان دادن یک پیغام فوری، اطلاعات و یا یک هشدار به کاربران استفاده می شود. برای نشان دادن یک پیغام به راحتی می توان از متد ()Show کلاس MessageBox استفاده نمایید. ساده ترین حالت متد ()Show این است که یک رشته متنی را به عنوان آرگومان قبول می کند و آن را نمایش می دهد.

MessageBox.Show("Hello World!");

message-box-12-19-10-001
شما همچنین می توانید به راحتی و با استفاده از یکی دیگر از سربارگذاریهای متد ()Show یک عنوان برای جعبه پیامتان بگذارید.

MessageBox.Show("Hello World!", "A Message");

message-box-12-19-10-01
اگر نخواهید از دکمه OK پیشفرض جعبه متن استفاده کنید می توانید با استفاده از System.Windows.Forms.MessageBoxButtons آنرا تغییر دهید.

MessageBox.Show("Hello World!", "A Message", MessageBoxButtons.OKCancel);

message-box-12-19-10-02
جدول زیر اعضای 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);

در جدول زیر انواع آیکونها و کاربرد آنها در جعبه پیام نشان داده شده است :

آیکون عضو استفاده
icon-information Asterisk
Information
برای نشان دادن اطلاعات به کاربر
icon-error Error
Hand
Stop
برای نشان دادن یک پیغام خطا
icon-warning Exclamation
Warning
برای نشان دادن یک هشدار
icon-question 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
                );

MessageBox-in-c#-01
همانطور که در کد بالا مشاهده می کنید رنگ دکمه OK نسبت به دکمه Cancel متفاوت است که نشان دهنده پیشفرض بودن این دکمه است. متد ()Show دارای پارامتر دیگری از نوع شمارشی MessageBoxOptions است که دارای مقادیر مختلفی است. یکی از این مقادیر RtlReading بوده که از آن برای راست به چپ کردن پیغام استفاده می شود :

MessageBox.Show(
                "Hello World!",
                "A Message",
                MessageBoxButtons.OKCancel,
                MessageBoxIcon.Information,
                MessageBoxDefaultButton.Button1,
                MessageBoxOptions.RtlReading
                );

MessageBox-in-c#-02

 

منبع:

همچنین ببینید

دانلود کتاب مبانی رایانش ابری

دانلود کتاب مبانی رایانش ابری

  دانلود کتاب مبانی رایانش ابری دانلود کتاب مبانی رایانش ابری از کتاب « مبانی …

پاسخ دهید

نشانی ایمیل شما منتشر نخواهد شد. بخش‌های موردنیاز علامت‌گذاری شده‌اند *