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

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

در برنامه‌نویسی با زبان سی شارپ، کنترل CheckedListBox یکی از کنترل‌های رایج و قدرتمند در طراحی رابط کاربری است که به کاربران این امکان را می‌دهد تا از میان یک لیست از گزینه‌ها، چندین گزینه را به صورت مستقل از هم انتخاب کنند.

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

این کنترل به‌ویژه برای زمانی که می‌خواهید به کاربر اجازه دهید چندین گزینه را انتخاب کند، کاربرد فراوانی دارد.

CheckedListBox یک کنترل است که مشابه با ListBox عمل می‌کند، با این تفاوت که به هر آیتم موجود در لیست یک CheckBox (چک‌باکس) متصل است.

بنابراین، کاربر می‌تواند برای هر گزینه از لیست انتخابی جداگانه ایجاد کند.

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

در CheckedListBox، هر آیتم در داخل لیست دارای یک چک‌باکس است که کاربر می‌تواند آن را علامت بزند یا از آن جدا کند.

این چک‌باکس‌ها به‌طور مستقل از یکدیگر عمل می‌کنند، یعنی کاربر می‌تواند هر تعداد از آیتم‌ها را که می‌خواهد انتخاب کند، بدون آنکه سایر انتخاب‌ها را تحت تأثیر قرار دهد.

ویژگی‌های مهم CheckedListBox

• ItemCheck

  این ویژگی به شما امکان می‌دهد تا وضعیت انتخاب آیتم‌ها را در CheckedListBox بررسی و تغییر دهید.

• CheckedItems

  مجموعه‌ای از آیتم‌های انتخاب شده را در یک CheckedListBox برمی‌گرداند.

• Items

  تمام آیتم‌های موجود در CheckedListBox را نمایش می‌دهد.

• SelectedIndex

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

این کنترل می‌تواند در بسیاری از سناریوهای مختلف، از جمله انتخاب چندین ویژگی از یک لیست، انتخاب دسته‌ای از موارد، و حتی مدیریت ورودی‌های فیلتر شده مورد استفاده قرار گیرد.

ایجاد CheckedListBox در فرم

در برنامه‌نویسی ویندوز فرم با سی شارپ، ایجاد و استفاده از یک CheckedListBox بسیار ساده است.

برای این کار می‌توانید از Toolbox در Visual Studio استفاده کنید و این کنترل را به فرم خود اضافه کنید.

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

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

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

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

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

در پنل Toolbox در Visual Studio، به دنبال کنترل CheckedListBox بگردید.

آن را از پنل Toolbox به فرم کشیده و رها کنید.

پس از قرار دادن کنترل در فرم، می‌توانید ویژگی‌ها و تنظیمات مختلف آن را از پنل Properties تغییر دهید.

• پیکربندی ویژگی‌ها و آیتم‌ها

  برای اضافه کردن آیتم‌ها به CheckedListBox، می‌توانید از خاصیت Items استفاده کنید.
  این خاصیت به شما این امکان را می‌دهد که به‌راحتی یک آرایه یا لیست از آیتم‌ها را به کنترل اضافه کنید.

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

using System;
using System.Windows.Forms;

namespace CheckedListBoxExample
{
    public class MainForm : Form
    {
        // تعریف CheckedListBox
        private CheckedListBox myCheckedListBox;
        private Button showSelectedButton;

        public MainForm()
        {
            // ایجاد CheckedListBox
            myCheckedListBox = new CheckedListBox();
            myCheckedListBox.Location = new System.Drawing.Point(50, 50);
            myCheckedListBox.Size = new System.Drawing.Size(200, 150);
            myCheckedListBox.Items.Add("Option 1");
            myCheckedListBox.Items.Add("Option 2");
            myCheckedListBox.Items.Add("Option 3");
            myCheckedListBox.Items.Add("Option 4");
            myCheckedListBox.Items.Add("Option 5");

            // ایجاد Button
            showSelectedButton = new Button();
            showSelectedButton.Text = "Show Selected";
            showSelectedButton.Location = new System.Drawing.Point(50, 220);
            showSelectedButton.Click += new EventHandler(ShowSelectedButton_Click);

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

        // رویداد کلیک دکمه برای نمایش آیتم‌های انتخاب شده
        private void ShowSelectedButton_Click(object sender, EventArgs e)
        {
            string selectedItems = "Selected items:\n";
            foreach (var item in myCheckedListBox.CheckedItems)
            {
                selectedItems += item + "\n";
            }
            MessageBox.Show(selectedItems);
        }

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

توضیحات کد:

• یک CheckedListBox با پنج گزینه ایجاد می‌شود.
• یک Button ایجاد می‌شود که با کلیک بر روی آن، آیتم‌های انتخاب‌شده از CheckedListBox استخراج و نمایش داده می‌شوند.
• ویژگی CheckedItems برای دستیابی به آیتم‌های انتخاب‌شده استفاده شده است.

مثال از ویژگی‌های CheckedListBox

مثال استفاده از ویژگی‌های CheckedItems و ItemCheck:

using System;
using System.Windows.Forms;

namespace CheckedListBoxWithEventExample
{
    public class MainForm : Form
    {
        private CheckedListBox myCheckedListBox;
        private Button showSelectedButton;

        public MainForm()
        {
            // ایجاد CheckedListBox
            myCheckedListBox = new CheckedListBox();
            myCheckedListBox.Location = new System.Drawing.Point(50, 50);
            myCheckedListBox.Size = new System.Drawing.Size(200, 150);
            myCheckedListBox.Items.Add("Option 1");
            myCheckedListBox.Items.Add("Option 2");
            myCheckedListBox.Items.Add("Option 3");
            myCheckedListBox.Items.Add("Option 4");
            myCheckedListBox.Items.Add("Option 5");

            // اضافه کردن رویداد برای تغییر وضعیت آیتم‌ها
            myCheckedListBox.ItemCheck += new ItemCheckEventHandler(MyCheckedListBox_ItemCheck);

            // ایجاد Button
            showSelectedButton = new Button();
            showSelectedButton.Text = "Show Selected";
            showSelectedButton.Location = new System.Drawing.Point(50, 220);
            showSelectedButton.Click += new EventHandler(ShowSelectedButton_Click);

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

        // رویداد برای بررسی تغییر وضعیت آیتم‌ها
        private void MyCheckedListBox_ItemCheck(object sender, ItemCheckEventArgs e)
        {
            MessageBox.Show($"Item '{myCheckedListBox.Items[e.Index]}' is now {(e.NewValue == CheckState.Checked ? "Checked" : "Unchecked")}");
        }

        // رویداد کلیک دکمه برای نمایش آیتم‌های انتخاب شده
        private void ShowSelectedButton_Click(object sender, EventArgs e)
        {
            string selectedItems = "Selected items:\n";
            foreach (var item in myCheckedListBox.CheckedItems)
            {
                selectedItems += item + "\n";
            }
            MessageBox.Show(selectedItems);
        }

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

در این کد:

• ItemCheck به CheckedListBox اضافه شده است که هر زمان وضعیت یک آیتم تغییر کند (از انتخاب به غیر انتخاب و بالعکس)، پیغامی به کاربر نشان داده می‌شود.
• CheckedItems برای نمایش تمام آیتم‌های انتخاب‌شده در CheckedListBox به کار می‌رود.

 

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

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

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

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

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

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

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

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

 

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

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

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

• انتخاب فیلترها

  در برنامه‌های جستجو یا فیلتر داده‌ها، کاربران می‌توانند فیلترهای مختلف را از لیست انتخاب کرده و داده‌ها را بر اساس آن‌ها فیلتر کنند.

• جمع‌آوری داده‌های انتخابی

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

• نظرسنجی و انتخاب دسته‌ای

  در سناریوهایی مانند نظرسنجی‌ها، جایی که کاربران می‌توانند بیش از یک انتخاب انجام دهند، از CheckedListBox استفاده می‌شود.

کنترل CheckedListBox در سی شارپ یک ابزار قدرتمند برای نمایش لیستی از گزینه‌هاست که به کاربران اجازه می‌دهد چندین گزینه را به‌طور مستقل از یکدیگر انتخاب کنند.