CesGridView - CesSolutions/Ces.WinForm.UI GitHub Wiki

Description / توضیح

This control is inherited from .Net "DataGridView" and has all features and properties of .Net "DatGridView" and just some properties added to "CesGridView" to provide new features for user to filter and sort data in grid. Of course, these features do not work on "Button & Combo" column type.

کنترل گرید از گرید دات نت ارث بری شده و تمام ویژگی های گرید دات نت را دارا می باشد و تنها چند ویژگی به آن اضافه شده که امکان فیلتر کردن داده های موجود در گرید را امکانپذیر خواهد کرد. البته فیلترینگ روی ستون هایی از نوع Button و Combo اعمال نمی شود.

Properties / ویژگی ها

  • CesDataSource : Assign data source to control.
  • CesEnableFiltering : Value must be selected from "CesGridFilterActionModeEnum". Elements of this enum define which mouse click can open filter or sort dialog.
  • CesSetAppearance : If set value to true, control automatically set some UI properties according to "CesUserDarkHeader" property
  • CesDarkMode : If set value to true, column and row header change to dark mode.
  • CesLoadingMode : If set value to true, loading screen appear in from of control
  • CesRowSizeMode : Row height of grid can be set from "CesGridViewRowSizeModeEnum"
  • CesDataSource : لیست داده ها باید از طریق این ویژگی به کنترل ارسال گردد.
  • CesEnableFiltering : این ویژگی امکان فیلتر کردن و مرتب کردن اطلاعات گرد را فراهم خواهد کرد و می تواند یک از گزینه های لیست شمارشی CesGridFilterActionModeEnum باشد.
  • CesSetAppearance : اگر مقدار این ویژگی برابر true باشد، کنترل ظاهر پیش فرض را تغییر خواهد داد.
  • CesDarkMode : اگر مقدار این ویژگی برابر true باشد، در تنظیم ظاهر کنترل، عنوان ستون و سطر تیره خواهد شد.
  • CesLoadingMode : اگر برابر true تنظیم شود که صفحه Loading در مقابل کنترل نمایش داده خواهد شد
  • CesRowSizeMode : ارتفاع ردیف‌ها می تواند یکی از مقادیر "CesGridViewRowSizeModeEnum" باشد

White & Dark mode with CesRowSizeMode = Compact

White & Dark mode with CesRowSizeMode = Normal

White & Dark mode with CesRowSizeMode = Comfortable

Loading Mode

If filtering result dose not return any value, following feature will appear to allow user to clear all filtering parameters and show original data. In previous version user must press Ctrl+D to remove all filtering paramters.

چنانچه فیلترینگ مقداری را برنگرداند، گرید یک دکمه جهت لغو فیلترینگ نمایش خواهد داد. در نسخه قبلی باید با Ctrl+D این کار انجام میشد که این ویژگی حذف و قابلیت جدید در تصویر مشخص شده است.

CesGridFilterActionModeEnum

public enum CesGridFilterActionModeEnum
{
    None,
    RightClick,
    LeftClick,
}

CesGridViewRowSizeModeEnum

public enum CesGridViewRowSizeModeEnum
{
    Compact = 20,
    Normal = 30,
    Comfortable = 38,
}
public class MyData
{
    public string Name { get; set; } = string.Empty;
    public string Description { get; set; } = string.Empty;
    public int QTY { get; set; }
    public bool Valid { get; set; }
    public DateTime Done { get; set; }
}

IList<MyData> source = new List<MyData>();
dgv.CesDataSource = mainData;

Icons / آیکن ها

If set value of "CesEnableFiltering" to "LeftClick/RightClick", icons will appear on column header but if set to "None" will disappear.

اگر گزینه "CesEnableFiltering" فعال باشد آیکن ها نمایش داده خواهند شد ولی اگر مقدار این ویژگی برابر None باشد هیچ آیکنی نمایش داده نخواهد شد.

⚠️ **GitHub.com Fallback** ⚠️