CesComboBox - CesSolutions/Ces.WinForm.UI GitHub Wiki

Description / توضیح

Items of this control can be text and image. Each Item is "CesComboBoxItem" class.

آیتم های این کمبوباکس می تواند شامل متن و تصویر باشد. هر آیتم از این کمبو باکس یک نوع "CesComboBoxItem" است.

Properties / ویژگی ها

  • CesDataSource : Assign data source to show in popup window.
  • CesItemHeight : Set each item height.
  • CesImageWidth : Set image width in each item.
  • CesShowIndicator : If set value to true, when user move mouse over items, instead of highlight the item, shows an indictor next to item.
  • CesShowImage : Show/Hide image of item.
  • CesAlignToRight : If set value to true, popup window align to right edge of control.
  • CesPopupSize : Set new size for popup.
  • CesSource : Set source to show in combobox.
  • CesSelectedItem : Get selected item.
  • CesSelectedValue : Get selected ValueMember from CesSelectedItem.
  • CesAdjustPopupToParentWidth : If set value to true, popup width will be set to control width.
  • CesShowClearButton : Show/Hide clear button inside the control.
  • CesShowAddItemButton : Show/Hide Add button inside the control. User can add codes for CesAddItemClicked.
  • CesShowEditItemButton : Show/Hide Edit button inside the control. User can add codes for CesEditItemClicked.
  • CesShowReloadDataButton : Show/Hide Reload Data button inside the control. User can add codes for CesReloadDataClicked.
  • CesLoadingMode : Set value to true to show user, loading operation is running.
  • CesKeepPreviousSelection : After loading data, previous selection will select automatically
  • CesSelectFirstItemIfPreviousWasNull : After loading data, automatically select first item if previous value was null
  • CesSelectFirstItem : After loading data, automatically select first item
  • CesDropDownOnFocus : Allow control to show popup automatically after got focused.
  • CesDataSource: تخصیص لیستی از داده ها جهت نمایش در منوی باز شونده.
  • CesItemHeight : ارتفاع آیتم ها.
  • CesImageWidth : عرض تصویر هر آیتم.
  • CesShowIndicator : نمایش نشانگر رنگی در کنار آیتمی که ماوس روی آن قرار گیرد. در این مواقع آیتم Highlight نخواهد شد.
  • CesShowImage : امکان نمایش تصویر برای هر آیتم
  • CesAlignToRight : تراز منوی باز شوند از سمت راست کنترل.
  • CesPopupSize : تعیین اندازه اولیه برای منوی باز شونده.
  • CesSource : تخصیص یک لیست از نوع CesSimpleComboBox.
  • CesSelectedItem : آیتم انتخاب شده را بر می گرداند..
  • CesSelectedValue : مقدار ValueMember را از CesSelectedItem بر می گرداند.
  • CesAdjustPopupToParentWidth : نمایش منوی بازشوند با عرض هم تراز با کنترل. در این مواقع اندازه تعیین شده اعمال نخواهد شد.
  • CesShowClearButton : امکان نمایش دکمه حذف آیتم انتخاب شده.
  • CesShowAddItemButton : امکان نمایش دکمه افزودن آیتم. کاربر می تواند در رویداد CesAddItemClicked کد نویسی کند.
  • CesShowEditItemButton : امکان نمایش دکمه ویرایش آیتم. کاربر می تواند در رویداد CesEditItemClicked کد نویسی کند.
  • CesShowLoadButton : امکان نمایش دکمه بارگذاری اطلاعات. کاربر می تواند در رویداد CesLoadClicked کد نویسی کند.
  • CesLoadingMode : اگر مقدار این ویژگی true .باشد به کاربر اعلان می‌کند که عملیات بارگذاری در حال انجام است
  • CesKeepPreviousSelection : انتخاب خودکار آیتم جاری بعد از بارگذاری مجدد
  • CesSelectFirstItemIfPreviousWasNull : اگر در بارگذاری مجدد آیتم قبلی وجود نداشته باشد برنامه اولین آیتم را انتخا خواهد کرد
  • CesSelectFirstItem : انتخاب اولین آیتم بعد از بارگذاری داده‌ها در کنترل
  • CesDropDownOnFocus : اجازه می‌دهد تا کنترل پس از دریافت فوکوس، منوی کمبو را خودکار باز کند

CesComboBoxItem

Each item ofcombobox is CesComboBoxItem and its constructor needs two parameters and must be defined.

  • CesItem : This parameter is "CesSimpleComboBoxItem" class and is a data structure for each item.
  • CesOptions : This parameter is "CesComboBoxOptions" class and contains all configuration of each items.

هر آیتم از کمبو باکس از نوع CesComboBoxItem می باشد که در سازنده این کلاس باید دو پارامتر از نوع CesSimpleComboBoxItem و CesComboBoxOptions تعریف شود.

  • CesItem : ویژگی است که در پارامتر سازنده کلاس مقدار دهی می شود و از نوع CesSimpleComboBoxItem می باشد.
  • CesOptions : در سازنده کلاس مقدار دهی می شود و از نوع CesComboBoxOptions می باشد.

CesSimpleComboBoxItem

Each item of "CesComboBox" get its data by following structure:

  • Text : Text of item.
  • Value : Value of item.
  • Image : Image of item.

هر یک از آیتم های کمبوباکس از نوع CesSimpleComboBox می باشد که دارای سه ویژگی است:

  • Text : متنی که باید نمایش داده شود.
  • Value : مقدار کلید هر آیتم.
  • Image : تعیین تصور برای آیتم.

CesComboBoxOptions

  • ShowIndicator : If value set to true, when user move mouse on item, instead of highlight the item, show indicator next to item.
  • ShowImage : Show/Hide image.
  • ImageWidth : Set image width.
  • ItemHeight : Set item height.
  • ItemWidth : Set item width.
  • ShowIndicator : امکان نمایش نشانگر بجای Highlught کردن آیتم در زمان حرکت ماوس روی هر آیتم.
  • ShowImage : امکان نمایش تصویر برای هر آیتم.
  • ImageWidth : تعیین پهنای تصویر هر آیتم.
  • ItemHeight : ارتفاع آیتم ها.
  • ItemWidth : تعیین پهنای آیتم ها.

Methods/ متدها

  • GetValue< T >("Property Name"): A generic method, that return property value from selected item. default property is "Id" it is not necessary to define it but, defining value type is mandatory.
  • GoToValueMember< T >("searchValue"): A generic method to find and select item according to input parameter to search in "CesValueMember". If nothing found, return default value.
  • GoToDisplyMember< T >("searchValue"): A generic method to find and select item according to input parameter to search in "CesDisplyMember". If nothing found, return default value.
  • ClearPreviousSelection() :
  • HasPreviousSelection() :
  • GetValue< T >("Property Name"): یک متد جنریک جهت دریافت مقدار یک Property از CesSelecteditem. نام Property بصورت پیش فرض Id می باشد و الزامی برای تعریف آن در پارامتر متد نیست ولی نوع مقدار برگشتی باید تعیین شود.
  • GoToValueMember< T >("searchValue"): این متد جنریک آیتم مورد نظر را با توجه به پارامتر ورودی در CesValueMember جستجو خواهد کرد و در صورت یافتن مقدار گزینه مورد نظر را انتخاب خواهد کرد. اگر آیتمی پیدا نشود مقدار پیش فرض برگردانده خواهد شد.
  • GoToDisplayMember< T >("searchValue"): این متد جنریک آیتم مورد نظر را با توجه به پارامتر ورودی در CesDisplayMember جستجو خواهد کرد و در صورت یافتن مقدار گزینه مورد نظر را انتخاب خواهد کرد. اگر آیتمی پیدا نشود مقدار پیش فرض برگردانده خواهد شد.
  • ClearPreviousSelection() : حذف شناسه آیتم قبلی
  • HasPreviousSelection() : بررسی می‌کند که آیا شناسه قبلی وجود دارد یا خیر

Events / رویدادها

  • CesSelectedItemChanged : Raises event if user click on each item.
  • CesAddItemClicked : User can assign codes to this event to add new item to data source
  • CesEditItemClicked : User can assign codes to this event to edit selected item.
  • CesLoadClicked : User can load/reload data according to his need.
  • CesSelectedItemChanged : اگر کاربر یک آیتم از کمبو را انتخاب کنداین رویداد اجرا می شود.
  • CesAddItemClicked : امکان کدنویسی جهت افزودن اطلاعات به منبع داده با توجه به نیاز کاربر.
  • CesEditItemClicked : امکان کدنویسی جهت ویرایش آیتم انتخاب شده با توجه به نیاز کاربر.
  • CesLoadClicked : امکان کدنویسی جهت بازنشانی اطلاعات با توجه به نیاز کاربر.

Example / مثال

public partial class Form1 : Form
{
    public Form1()
    {
        InitializeComponent();
    }

    IList<Ces.WinForm.UI.CesComboBox.CesSimpleComboBoxItem> source =
        new List<Ces.WinForm.UI.CesComboBox.CesSimpleComboBoxItem>();

    private void Form1_Load(object sender, EventArgs e)
    {
        source.Clear();

        source.Add(new Ces.WinForm.UI.CesComboBox.CesSimpleComboBoxItem("item ", null, Image.FromFile(@"E:\Icon\24\001-file.png")));
        source.Add(new Ces.WinForm.UI.CesComboBox.CesSimpleComboBoxItem("item ", null, Image.FromFile(@"E:\Icon\24\add.png")));
        source.Add(new Ces.WinForm.UI.CesComboBox.CesSimpleComboBoxItem("item ", null, Image.FromFile(@"E:\Icon\24\arrow-back-1-icon.png")));
        source.Add(new Ces.WinForm.UI.CesComboBox.CesSimpleComboBoxItem("item ", null, Image.FromFile(@"E:\Icon\24\Arrow-download-2-icon.png")));
        source.Add(new Ces.WinForm.UI.CesComboBox.CesSimpleComboBoxItem("item ", null, Image.FromFile(@"E:\Icon\24\002-question.png")));
        source.Add(new Ces.WinForm.UI.CesComboBox.CesSimpleComboBoxItem("item ", null, Image.FromFile(@"E:\Icon\24\002-question.png")));
        source.Add(new Ces.WinForm.UI.CesComboBox.CesSimpleComboBoxItem("item ", null, Image.FromFile(@"E:\Icon\24\002-question.png")));

        this.cesSimpleComboBox1.CesDataSource = source;
    }
}

In a simple mode, you set text only.

در حالت ساده می توان فقط متن را مشخص کرد:

public partial class Form1 : Form
{
    public Form1()
    {
        InitializeComponent();
    }

    IList<Ces.WinForm.UI.CesComboBox.CesSimpleComboBoxItem> source =
        new List<Ces.WinForm.UI.CesComboBox.CesSimpleComboBoxItem>();

    private void Form1_Load(object sender, EventArgs e)
    {
        source.Clear();

        source.Add(new Ces.WinForm.UI.CesComboBox.CesSimpleComboBoxItem("item1"));
        source.Add(new Ces.WinForm.UI.CesComboBox.CesSimpleComboBoxItem("item2"));
        source.Add(new Ces.WinForm.UI.CesComboBox.CesSimpleComboBoxItem("item3"));
        source.Add(new Ces.WinForm.UI.CesComboBox.CesSimpleComboBoxItem("item4"));
        source.Add(new Ces.WinForm.UI.CesComboBox.CesSimpleComboBoxItem("item5"));

        this.cesSimpleComboBox1.CesDataSource = source;
    }
}
⚠️ **GitHub.com Fallback** ⚠️