CesMessageBox - CesSolutions/Ces.WinForm.UI GitHub Wiki

توضیح

در کللاس CesMessageBox می توانید به سادگی یک کادر پیغام نمایش بدهید و آیکن مورد نظر به همراه دکمه های قابل نمایش را برای آن تنظیم کنید. همچنین کاربر می تواند با کلیک روی دکمه Copy متن پیغام را در حافظه کپی نماید. همچنین این امکان وجود دارد که بتوانید متن دکمه ها را سفارشی کنید و ازعبارات فارسی نیز استفاده کنید.

نمایش پیغام

جهت نمایش کادر پیغام می توان براحتی دستور زیر را اجرا کرد:
Ces.WinForm.UI.CesMessageBox.CesMessage.Show("Hello World...");
متد Show دارای دو پارامتر است که اولی متن پیغام و دومین پارامتر که اختیاری است، از نوع CesMessageBoxOptions می باشد که پارامترهای آن بدین صورت است:
  • Title : تعیین عنوان برای کادر پیغام.
  • Icon : تعیین نوع آیکن برای کادر پیغام که می تواند یکی از مقادیر CesMessageBoxIconEnum باشد.
  • Buttons : تعیین دکمه های کادر پیغام که می تواند یکی از مقادیر CesMessageBoxButtonsEnum باشد.
  • TopMost : اگر مقدار این ویژگی برابر true باشد کادر پیغام روی تمام پنجره ها قرار خواهد گرفت.
  • Size : تعیین اندازه کارد پیغام که می تواند یکی از مقادیر CesMessageBoxSizeEnum باشد.
  • ButtonImage : با استفاده از این ویژگی میتوان یکی از اعضای لیست شمارشی CesMessageBoxButtonImageEnum را انتخاب کرد تا برنامه دکمه ها را یا بصورت متن و یا تصویر نمایش دهد.
  • TextImageRelation : این ویژگی چگونگی نمایش متن و تصویر را در دکمه ها مشخص می کند و می تواند یکی از اعضای لیست شمارشی TextImageRelation باشد که مربوط به دات نت است و در فضای System.Windows.Forms قرار دارد.
  • ButtonCaption : این ویژگی از نوع کلاس CesMessageBoxButtonCaption است که در زمان نمونه سازی دارای مقادیر پیشفرض است و کاربر می تواند مقادیر آن را به دلخواه تغییر بدهد.

لیست شمارشی CesMessageBoxIconEnum

    public enum CesMessageBoxIconEnum
    {
        None,
        MessageAsterisk,
        MessageExclamation,
        MessageHandStop,
        MessageInformation,
        MessageQuestion,
        MessageStop,
        MessageSuccess,
        MessageWarning,
        MessageError,
    }

لیست شمارشی CesMessageBoxSizeEnum

    public enum CesMessageBoxSizeEnum
    {
        Small, //430 * 160
        Medium, //640 * 230
        Large, //890 * 480
    }

لیست شمارشی CesMessageBoxButtonsEnum

    public enum CesMessageBoxButtonsEnum
    {
        Ok,
        OkCancel,
        RetryCancel,
        YesNo,
        YesNoCancel,
        AbortRetryIgnore,
    }

لیست شمارشی CesMessageBoxButtonImageEnum

    public enum CesMessageBoxButtonImageEnum
    {
        TextOnly,
        ImageOnly,
        TextAndImage
    }

کلاس CesMessageBoxOptions

پارامتر دوم متد Show از نوع کلاس CesMessageBoxOptions می باشد که بصورت زیر پیاده شده است:
    public class CesMessageBoxOptions
    {
        public Size _small { get; set; } = new Size(430, 160);
        public Size _medium { get; set; } = new Size(640, 230);
        public Size _large { get; set; } = new Size(890, 480);

        public CesMessageBoxOptions()
        {
            Title = "Message Box";
            Icon = CesMessageBoxIconEnum.MessageInformation;
            Buttons = CesMessageBoxButtonsEnum.Ok;
            TopMost = true;
            Size = CesMessageBoxSizeEnum.Small;
            ButtonImage = CesMessageBoxButtonImageEnum.TextAndImage;
            TextImageRelation = TextImageRelation.ImageAboveText;
            ButtonCaption = new CesMessageBoxButtonCaption();
        }

        public string? Title { get; set; }
        public CesMessageBoxIconEnum Icon { get; set; }
        public CesMessageBoxButtonsEnum Buttons { get; set; }
        public bool TopMost { get; set; }
        public CesMessageBoxSizeEnum Size { get; set; }
        public CesMessageBoxButtonImageEnum ButtonImage { get; set; }
        public System.Windows.Forms.TextImageRelation TextImageRelation { get; set; }
        public CesMessageBoxButtonCaption ButtonCaption { get; set; }
    }

کلاس CesMessageBoxButtonCaption

در این کلاس میتوانید برایتمام دکمه های کادر پیغام متن مورد نظر را جایگزین کنید.
public class CesMessageBoxButtonCaption
{
    public string CesMessageBoxOk { get; set; } = "Ok";
    public string CesMessageBoxYes { get; set; } = "Yes";
    public string CesMessageBoxNo { get; set; } = "No";
    public string CesMessageBoxCancel { get; set; } = "Cancel";
    public string CesMessageBoxRetry { get; set; } = "Retry";
    public string CesMessageBoxAbort { get; set; } = "Abort";
    public string CesMessageBoxIgnore { get; set; } = "Ignore";
    public string CesMessageBoxCopy { get; set; } = "Copy";
}

مثال

var opt = new Ces.WinForm.UI.CesMessageBox.CesMessageBoxOptions
{
    Title = "Ces Win UI",
    Icon = Ces.WinForm.UI.CesMessageBox.CesMessageBoxIconEnum.MessageHandStop,
    Buttons = Ces.WinForm.UI.CesMessageBox.CesMessageBoxButtonsEnum.YesNo,
    TopMost = false,
    Size = Ces.WinForm.UI.CesMessageBox.CesMessageBoxSizeEnum.Medium
};

Ces.WinForm.UI.CesMessageBox.CesMessage.Show("Hello World...!", opt);
⚠️ **GitHub.com Fallback** ⚠️