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

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

در برنامه‌نویسی سی شارپ، یکی از کنترل‌های بسیار مفید برای تعامل با کاربر در رابط کاربری ComboBox است.

این کنترل به شما این امکان را می‌دهد که یک لیست از گزینه‌ها را به‌صورت فشرده نمایش داده و کاربران را قادر می‌سازد تا یکی از این گزینه‌ها را انتخاب کنند.

ComboBox معمولاً در مواقعی استفاده می‌شود که تعداد گزینه‌ها زیاد است، اما فضای صفحه محدود است. با استفاده از ComboBox، کاربران می‌توانند از میان چندین انتخاب، یکی را انتخاب کرده و آن را در برنامه اعمال کنند.

ComboBox یکی از کنترل‌های Windows Forms است که ترکیبی از یک TextBox و یک ListBox را در خود جای می‌دهد.

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

برخلاف ListBox که تمام گزینه‌ها را به‌طور ثابت نمایش می‌دهد، ComboBox این گزینه‌ها را به‌صورت کشویی نمایش می‌دهد، به‌طوری‌که فضای صفحه به‌طور بهینه استفاده می‌شود.

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

ComboBox در دو حالت قابل استفاده است:

• Drop-down

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

• Drop-down List

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

ویژگی‌های ComboBox در سی شارپ

• Items

  لیستی از آیتم‌هایی که در ComboBox نمایش داده می‌شوند.

• SelectedItem

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

• SelectedIndex

  ایندکس آیتم انتخاب‌شده.

• DropDownStyle

  نوع نمایش لیست (Drop-down یا Drop-down List).

• AutoCompleteMode

  حالت کامل‌کننده خودکار برای کمک به کاربران در تایپ کردن مقادیر.

• MaxDropDownItems

  حداکثر تعداد آیتم‌هایی که باید در کشویی نمایش داده شوند.

ایجاد ComboBox در فرم

برای ایجاد و استفاده از ComboBox در سی شارپ، ابتدا باید آن را به فرم خود اضافه کرده و سپس به‌طور برنامه‌نویسی با آن تعامل کنید. این کار بسیار ساده است و می‌توان آن را در محیط Visual Studio انجام داد.

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

  ابتدا در Visual Studio یک پروژه جدید از نوع Windows Forms App ایجاد کنید. این پروژه باید یک فرم طراحی شده داشته باشد که در آن از ComboBox استفاده خواهید کرد.

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

  در Toolbox، شما می‌توانید کنترل ComboBox را مشاهده کنید. برای افزودن این کنترل به فرم، مراحل زیر را دنبال کنید:

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

پس از قرار دادن ComboBox در فرم، می‌توانید ویژگی‌های آن را از پنل Properties تنظیم کنید.
ویژگی‌هایی مانند اندازه، موقعیت، و حالت نمایش (Drop-down یا Drop-down List) را می‌توانید تغییر دهید.

• تنظیم ویژگی‌ها و رویدادها

  بعد از اضافه کردن ComboBox به فرم، می‌توانید ویژگی‌ها و رویدادهای مختلف آن را تنظیم کنید.
  
  

using System;
using System.Windows.Forms;

namespace ComboBoxExample
{
    public class MainForm : Form
    {
        private ComboBox comboBox;
        private Button displayButton;

        public MainForm()
        {
            // ایجاد ComboBox
            comboBox = new ComboBox();
            comboBox.Location = new System.Drawing.Point(50, 50);
            comboBox.Size = new System.Drawing.Size(200, 30);

            // اضافه کردن آیتم‌ها به ComboBox
            comboBox.Items.Add("Red");
            comboBox.Items.Add("Green");
            comboBox.Items.Add("Blue");

            // انتخاب پیش‌فرض
            comboBox.SelectedIndex = 0;

            // ایجاد دکمه برای نمایش آیتم انتخاب‌شده
            displayButton = new Button();
            displayButton.Text = "Display Selected Color";
            displayButton.Location = new System.Drawing.Point(50, 100);
            displayButton.Click += new EventHandler(DisplayButton_Click);

            // افزودن کنترل‌ها به فرم
            this.Controls.Add(comboBox);
            this.Controls.Add(displayButton);
        }

        // رویداد کلیک دکمه برای نمایش انتخاب کاربر
        private void DisplayButton_Click(object sender, EventArgs e)
        {
            string selectedColor = comboBox.SelectedItem.ToString();
            MessageBox.Show("You selected: " + selectedColor);
        }

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

توضیحات کد:

• در این کد، یک ComboBox به فرم اضافه شده است و سه رنگ به عنوان آیتم به آن افزوده شده است.
• دکمه‌ای به نام displayButton ساخته شده که پس از کلیک، رنگ انتخاب‌شده در ComboBox را در یک MessageBox نمایش می‌دهد.

 

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

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

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

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

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

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

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

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

 

 

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

ComboBox در سی شارپ دارای ویژگی‌های مختلفی است که می‌توانند برای تنظیم رفتار و ظاهر آن استفاده شوند. 

• Items

  لیستی از آیتم‌هایی است که در ComboBox نمایش داده می‌شوند.
  این آیتم‌ها می‌توانند از نوع string، int یا حتی شیء‌های سفارشی باشند.
  برای اضافه کردن آیتم‌ها، می‌توانید از متدهای Add، AddRange یا Insert استفاده کنید.

comboBox.Items.Add("Red");
comboBox.Items.Add("Green");
comboBox.Items.Add("Blue");

• SelectedItem

  این ویژگی حاوی آیتمی است که کاربر در حال حاضر انتخاب کرده است.
  این ویژگی برای دریافت یا تنظیم آیتم انتخاب‌شده از ComboBox استفاده می‌شود.

string selectedColor = comboBox.SelectedItem.ToString();

• SelectedIndex

  این ویژگی ایندکس آیتم انتخاب‌شده در ComboBox را نشان می‌دهد.
  ایندکس‌ها از صفر شروع می‌شوند.

int selectedIndex = comboBox.SelectedIndex;

• DropDownStyle

  این ویژگی تعیین می‌کند که ComboBox به صورت کشویی (Drop-down) باشد یا تنها گزینه‌ها را به صورت لیست نمایش دهد.
  به‌طور پیش‌فرض، ComboBox از حالت Drop-down استفاده می‌کند.

comboBox.DropDownStyle = ComboBoxStyle.DropDownList;

• AutoCompleteMode

  این ویژگی به شما اجازه می‌دهد که به کاربران امکان دهید به صورت خودکار پیشنهادهایی برای تکمیل واردات خود دریافت کنند.
  به این ترتیب، ComboBox به کاربران پیشنهادات مشابه به ورودی‌های آنها را نشان می‌دهد.

comboBox.AutoCompleteMode = AutoCompleteMode.SuggestAppend;
comboBox.AutoCompleteSource = AutoCompleteSource.ListItems;

• MaxDropDownItems

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

comboBox.MaxDropDownItems = 5;

کاربردهای ComboBox در سی شارپ

• انتخاب از میان گزینه‌های ثابت

  ComboBox معمولاً برای انتخاب از میان گزینه‌های ثابت مانند انتخاب رنگ، اندازه فونت، یا دسته‌بندی‌های مختلف استفاده می‌شود.

• فرم‌های ورود اطلاعات

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

• فیلتر کردن داده‌ها

  در برنامه‌هایی که داده‌های زیادی دارند، می‌توان از ComboBox برای فیلتر کردن داده‌ها استفاده کرد.
  به عنوان مثال، در برنامه‌های فروشگاه آنلاین، می‌توان از ComboBox برای انتخاب دسته‌بندی محصولات استفاده کرد.

• تنظیمات نرم‌افزار

  در تنظیمات نرم‌افزار، ComboBox می‌تواند برای انتخاب تنظیمات از میان گزینه‌های مختلف (مثل تم‌ها یا زبان‌ها) استفاده شود.