کنترل CheckBox در سی شارپ

کنترل CheckBox در سی شارپ

کنترل CheckBox در سی‌شارپ برای نمایش گزینه‌هایی است که کاربر می‌تواند یکی یا چند مورد از آن‌ها را انتخاب کند.

این کنترل دارای یک حالت انتخاب شده (Checked = true) یا انتخاب نشده (Checked = false) است و معمولاً برای انتخاب‌های چندتایی در فرم‌ها استفاده می‌شود.

می‌توان ویژگی‌هایی مانند Text برای عنوان چک‌باکس و Checked برای تعیین وضعیت اولیه آن را تنظیم کرد.

رویداد مهم در CheckBox، رویداد CheckedChanged است که هنگام تغییر وضعیت انتخاب آن اجرا می‌شود.

این رویداد برای اجرای کدی هنگام انتخاب یا برداشتن تیک چک‌باکس بسیار کاربردی است.

همچنین می‌توان با بررسی مقدار checkBox1.Checked در کد، منطق شرطی مختلفی بر اساس انتخاب یا عدم انتخاب پیاده‌سازی کرد.

کنترل CheckBox یک ابزار ساده و مؤثر برای تعامل بیشتر با کاربر در فرم‌های ویندوزی به شمار می‌رود.

ویژگی‌ها و حالت‌های CheckBox

در هنگام استفاده از CheckBox، می‌توانید ویژگی‌های مختلف آن را برای تغییر رفتار و ظاهر آن سفارشی کنید.

در اینجا برخی از مهم‌ترین ویژگی‌های CheckBox آورده شده است:

• Checked

  این ویژگی به شما می‌گوید که آیا CheckBox انتخاب شده است یا نه.
  اگر Checked = true باشد، به این معنا است که گزینه انتخاب شده است.
  اگر Checked = false باشد، گزینه غیر انتخاب شده است.

• Text

  متنی که در کنار CheckBox نمایش داده می‌شود.
  این متن می‌تواند نشان‌دهنده گزینه‌ای باشد که CheckBox مربوط به آن است.

• Name

  نام کنترل CheckBox که برای دسترسی به آن در کد استفاده می‌شود.

• AutoCheck

  به صورت پیش‌فرض، زمانی که کاربر بر روی CheckBox کلیک می‌کند، وضعیت آن تغییر می‌کند (از انتخاب شده به غیر انتخاب شده و بالعکس).
  اگر AutoCheck را روی false تنظیم کنید، تغییر وضعیت باید به‌طور دستی انجام شود.

• Appearance

  ظاهر CheckBox را مشخص می‌کند.
  می‌توانید آن را به حالت Button یا Normal تنظیم کنید.

• ThreeState

  اگر این ویژگی را true تنظیم کنید، CheckBox به سه حالت Checked، Unchecked، و Indeterminate (معلق) تغییر می‌کند.

کاربردهای رایج CheckBox

• تایید شرایط

  مانند انتخاب موافقت با شرایط استفاده در فرم‌های ثبت‌نام یا استفاده از نرم‌افزار.

• انتخاب ویژگی‌ها

  برای انتخاب چندین ویژگی به‌طور همزمان در هنگام پیکربندی نرم‌افزار.

• انتخاب‌های دوتایی

  برای انتخاب ویژگی‌هایی که نیاز به انتخاب یا رد دارند.

• گروه‌بندی گزینه‌ها

  برای انتخاب زیرمجموعه‌ای از داده‌ها در میان گزینه‌های مختلف.

 

آیا به دنبال یک فرصت عالی برای یادگیری برنامه‌نویسی هستید؟ 🚀

با دوره آموزشی سی‌شارپ ما، شما می‌توانید مهارت‌های خود را به سطح جدیدی ارتقا دهید! این دوره به‌طور کامل طراحی شده تا به شما کمک کند تا از مبتدی تا پیشرفته در دنیای برنامه‌نویسی سی‌شارپ پیش بروید.

👨‍🏫 چرا دوره ما را انتخاب کنید؟

• محتوای جامع و عملی: با پروژه‌های واقعی و تمرینات عملی، یادگیری را به تجربه‌ای جذاب تبدیل کنید.
• مدرس مجرب: از تجربه و دانش مدرس حرفه‌ای بهره‌مند شوید که شما را در هر مرحله از یادگیری راهنمایی می‌کنند.
• پشتیبانی ۲۴/۷: هر زمان که سوالی داشتید، ما در کنار شما خواهیم بود تا به شما کمک کنیم.
• دسترسی مادام‌العمر: به محتوای دوره دسترسی دائمی داشته باشید و هر زمان که خواستید، می‌توانید به آن مراجعه کنید.

💡 فرصت را از دست ندهید!

بایادگیری سی‌شارپ، می‌توانید در دنیای فناوری اطلاعات به یک متخصص تبدیل شوید و در پروژه‌های جذاب و چالش‌برانگیز شرکت کنید.

همین امروز به جمع یادگیرندگان ما بپیوندید و اولین قدم را به سوی آینده‌ای روشن‌تر بردارید!

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

 

ایجاد CheckBox در فرم

در پروژه‌های Windows Forms در سی شارپ، می‌توانید به راحتی از کنترل CheckBox برای دریافت ورودی از کاربر استفاده کنید.

برای این کار، ابتدا باید یک پروژه Windows Forms در Visual Studio ایجاد کنید و سپس از پنل Toolbox کنترل CheckBox را به فرم خود اضافه کنید.

در اینجا مراحل ایجاد یک CheckBox و تنظیمات آن توضیح داده شده است:

•  ایجاد پروژه جدید Windows Forms

  ابتدا در Visual Studio یک پروژه جدید از نوع Windows Forms App ایجاد کنید.

نام پروژه خود را وارد کرده و پروژه را بسازید.

• اضافه کردن CheckBox به فرم

  برای اضافه کردن یک CheckBox به فرم، کافی است مراحل زیر را دنبال کنید:

در پنل Toolbox، کنترل CheckBox را پیدا کنید.

آن را با کشیدن و رها کردن به فرم خود اضافه کنید.

می‌توانید ویژگی‌های مختلف کنترل مانند Text (متن نمایش داده شده)، Name (نام کنترل برای دسترسی به آن در کد)، Checked (حالت انتخاب‌شده یا غیر انتخاب‌شده) را تنظیم کنید.

• کدنویسی برای استفاده از CheckBox

  پس از اضافه کردن CheckBox به فرم، می‌توانید از آن در کد خود استفاده کنید. برای مثال، اگر بخواهید وضعیت انتخاب شده یا نشده CheckBox را دریافت کرده و بر اساس آن تصمیم‌گیری کنید، می‌توانید از ویژگی Checked استفاده کنید.

در اینجا یک مثال ساده از استفاده از CheckBox آورده شده است:

using System;
using System.Windows.Forms;

namespace CheckBoxExample
{
    public class MainForm : Form
    {
        // تعریف CheckBox
        private CheckBox myCheckBox;

        // تعریف یک دکمه برای نمایش نتیجه
        private Button myButton;

        public MainForm()
        {
            // ایجاد CheckBox
            myCheckBox = new CheckBox();
            myCheckBox.Text = "I agree to the terms and conditions"; // متن داخل CheckBox
            myCheckBox.Location = new System.Drawing.Point(50, 50); // موقعیت CheckBox در فرم
            myCheckBox.Size = new System.Drawing.Size(250, 30); // اندازه CheckBox

            // ایجاد Button
            myButton = new Button();
            myButton.Text = "Submit";
            myButton.Location = new System.Drawing.Point(50, 100);
            myButton.Click += new EventHandler(MyButton_Click);

            // اضافه کردن کنترل‌ها به فرم
            this.Controls.Add(myCheckBox);
            this.Controls.Add(myButton);
        }

        // رویداد دکمه برای نمایش وضعیت CheckBox
        private void MyButton_Click(object sender, EventArgs e)
        {
            if (myCheckBox.Checked)
            {
                MessageBox.Show("You agreed to the terms and conditions.");
            }
            else
            {
                MessageBox.Show("You did not agree to the terms and conditions.");
            }
        }

        [STAThread]
        static void Main()
        {
            Application.Run(new MainForm());
        }
    }
}

توضیحات کد:

• • در ابتدا یک CheckBox با متن "I agree to the terms and conditions" ایجاد می‌شود.
  • سپس یک Button ایجاد شده که هنگام کلیک شدن، وضعیت CheckBox را بررسی می‌کند.
  • اگر CheckBox انتخاب شده باشد، یک پیغام مبنی بر تایید شرایط نمایش داده می‌شود؛ در غیر این صورت، پیامی مبنی بر رد شرایط به کاربر نشان داده خواهد شد.

رویدادهای مهم CheckBox

CheckBox در سی شارپ شامل چندین رویداد است که به شما این امکان را می‌دهند که کنترل دقیقی بر روی رفتار آن داشته باشید:

• CheckedChanged

  این رویداد زمانی فراخوانی می‌شود که وضعیت Checked تغییر کند.
  برای مثال، اگر کاربر CheckBox را از حالت انتخاب شده به حالت غیر انتخاب شده تغییر دهد، این رویداد فعال می‌شود.

• Click

  رویدادی که زمانی فعال می‌شود که کاربر بر روی CheckBox کلیک می‌کند.

• MouseEnter و MouseLeave

  رویدادهایی که زمانی که ماوس وارد یا از روی CheckBox می‌رود، فعال می‌شوند.

• KeyDown و KeyUp

  رویدادهایی که وقتی کاربر کلیدی از صفحه‌کلید را فشار می‌دهد یا رها می‌کند، فعال می‌شوند.

مثال استفاده از رویداد CheckedChanged

using System;
using System.Windows.Forms;

namespace CheckBoxEventExample
{
    public class MainForm : Form
    {
        private CheckBox myCheckBox;
        private Label statusLabel;

        public MainForm()
        {
            myCheckBox = new CheckBox();
            myCheckBox.Text = "Accept terms and conditions";
            myCheckBox.Location = new System.Drawing.Point(50, 50);
            myCheckBox.CheckedChanged += new EventHandler(MyCheckBox_CheckedChanged);

            statusLabel = new Label();
            statusLabel.Location = new System.Drawing.Point(50, 100);
            statusLabel.Size = new System.Drawing.Size(300, 30);

            this.Controls.Add(myCheckBox);
            this.Controls.Add(statusLabel);
        }

        // رویداد برای بررسی تغییر وضعیت CheckBox
        private void MyCheckBox_CheckedChanged(object sender, EventArgs e)
        {
            if (myCheckBox.Checked)
            {
                statusLabel.Text = "You have accepted the terms and conditions.";
            }
            else
            {
                statusLabel.Text = "You have not accepted the terms and conditions.";
            }
        }

        [STAThread]
        static void Main()
        {
            Application.Run(new MainForm());
        }
    }
}

در این کد:

رویداد CheckedChanged به CheckBox اضافه شده است تا زمانی که وضعیت انتخاب شده تغییر کند، متنی به Label نمایش داده شود.