XtraEditors一、总体介绍

一、所有编辑器的公共功能

• 全部都可以绑定数据；
• 全部都可以独立使用或用于由 Developer Express 提供的容器控件 (XtraGrid、XtraVerticalGrid、XtraTreeList 和 XtraBars) 内的内置编辑；
• 全部都使用相同的样式、外观与感觉、以及工具提示机制，因为它们都派生于 BaseEdit 类。

要把某个特定的编辑器嵌入到容器控件中，则必须创建一个相应的 Repository 项。 Repository 项是一个组件，存储了属于某个对应编辑器的属性和事件。 容器控件使用由 repository 项提供的信息，来创建所需的全功能编辑器。

二、编辑器列表

有文本框的编辑器	REPOSITORY 项
ButtonEdit	RepositoryItemButtonEdit	一个文本编辑器，允许在编辑框内显示按钮。
HyperLinkEdit	RepositoryItemHyperLinkEdit	一个编辑器，允许编辑超链接并导航到其目标。
MemoEdit	RepositoryItemMemoEdit	一个编辑器，允许显示和编辑多行文本。
SpinEdit	RepositoryItemSpinEdit	一个编辑器，允许使用微调按钮来编辑数值。
TextEdit	RepositoryItemTextEdit	一个单行文本编辑器。
TimeEdit	RepositoryItemTimeEdit	一个编辑器，允许使用微调按钮来编辑时间值。
没有文本框的编辑器
CheckEdit	RepositoryItemCheckEdit	一个编辑器，提供了选中、未选中、以及可选用的变灰状态。 经常用于编辑 Boolean 值。
MarqueeProgressBarControl	RepositoryItemMarqueeProgressBar	通过连续从左到右地滚动一个进度块，来指示某项操作正在进行。
PictureEdit	RepositoryItemPictureEdit	一个编辑器，显示被存储为位图、元文件、图标、JPEG、GIF 或 PNG 格式的图像。
ProgressBarControl	RepositoryItemProgressBar	一个控件，指示某项漫长操作的进度。
RadioGroup	RepositoryItemRadioGroup	一个控件，提供了一组单选按钮。
RangeTrackBarControl	RepositoryItemRangeTrackBar	一个滑动栏，有两个滑动块，允许用户选择取值范围。
TrackBarControl	RepositoryItemTrackBar	一个滑动栏。
ZoomTrackBarControl	RepositoryItemZoomTrackBar	一个缩放滑动栏。
有弹出窗口的编辑器
CalcEdit	RepositoryItemCalcEdit	一个控件，提供了一个下拉计算器。
CheckedComboBoxEdit	RepositoryItemCheckedComboBoxEdit	一个编辑器，允许在一个弹出窗口中呈现和编辑一组 Boolean 选项或位字段。
ColorEdit	RepositoryItemColorEdit	一个编辑器，允许从下拉窗口中选取某种颜色。
ComboBoxEdit	RepositoryItemComboBox	一个文本编辑器，允许从下拉列表中选取预定义的项。 列表项由字符串表示。
DateEdit	RepositoryItemDateEdit	一个编辑器，允许使用下拉日历来编辑日期/时间值。
FontEdit	RepositoryItemFontEdit	一个编辑器，允许从下拉列表中选取某种字体。
ImageComboBoxEdit	RepositoryItemImageComboBox	一个组合框编辑器，它的列表项可以显示自定义图像。
ImageEdit	RepositoryItemImageEdit	一个编辑器，在它的弹出窗口中显示图像。
LookUpEdit	RepositoryItemLookUpEdit	一个编辑器，显示源自相关联的数据集中的多列记录列表。
MemoExEdit	RepositoryItemMemoExEdit	一个编辑器，允许在它的弹出窗口中编辑多行文本。
MRUEdit	RepositoryItemMRUEdit	一个文本编辑器，允许从下拉列表中选择最近输入的值。
PopupContainerEdit	RepositoryItemPopupContainerEdit	一个控件，可以在它的弹出窗口中显示其他控件。

三、控件的演示代码：

四、编辑器的层次结构

• BaseEdit 的直属子类 (不包括 TextEdit 编辑器)。
  该组中的每个编辑器都有自己的功能，并且没有与其他编辑器相同的功能。
• TextEdit 类及其直属子 MemoEdit 编辑器。
  这些编辑器分别显示一个支持单行或多行文本编辑的文本框。 请参阅 文本编辑概述 主题，来获得关于这些编辑器及其子类的特定功能的细节。
• ButtonEdit 类及其直属子 HyperLinkEdit 编辑器。
  除了继承的功能之外，这些编辑器还可以显示编辑器按钮。 请参阅 编辑器按钮概述 和 编辑器按钮快捷键 主题，来获得关于定制编辑器按钮的其他信息。
• BaseSpinEdit 类的直属子类 —— SpinEdit 和 TimeEdit 控件。
  除了继承的功能之外，这些编辑器还允许最终用户使用微调按钮来修改取值。 请参阅 微调按钮 主题，来获得其他信息。
• PopupBaseEdit 类的子类。
  除了继承的功能之外，这些编辑器还可以显示弹出窗口，并且允许控制其可用性、可视性和弹出窗口功能的其他外观。 请参阅 下拉编辑器概述 主题来学习更多内容。
• BlobBaseEdit 类的子类 —— ImageEdit 和 MemoExEdit 控件。
  除了继承的功能之外，这些编辑器还提供了使用其弹出窗口编辑 BLOB 数据的功能。 请参阅 BLOB 编辑器 主题，来获得其他信息。
• LookUpEditBase 类的子类实现了查找功能。 该类有两个子类： LookUpEdit 和 GridLookUpEdit 编辑器。
  GridLookUpEdit 控件使用一个内嵌 XtraGrid 控件实现了查找功能。 此控件由 XtraGrid 套件提供，并且不包括在 XtraEditors 库中。
  要获得更多关于查找功能的信息，请参阅 LookUpEdit 主题。
• ComboBoxEdit 类及其子类 (ImageComboBoxEdit、MRUEdit 和 FontEdit)。
  这些编辑器允许最终用户从下拉列表中选取某项取值。 请参阅 组合框编辑器 主题，来获知细节。
• TrackBarControl 类及其子类 (RangeTrackBarControl 和 ZoomTrackBarControl)
  呈现滑动栏 —— 显示一个或两个滑动块的控件，允许最终用户选取某个取值或某个取值范围。
• ProgressBarBaseControl 的子类 —— ProgressBarControl 和 MarqueeProgressBarControl。
  这些控件适用于指示漫长操作的进度。

BaseEdit

    BaseCheckEdit

    PictureEdit

    ProgressBarBaseControl

    RadioGroup

    RatingControl

    SparklineEdit

    TextEdit

    TokenEdit

    TrackBarControl

TextEdit

    MemoEdit

    ButtonEdit

        HyperLinkEdit

        PopupBaseEdit

            BaseSpinEdit

                SpinEdit

                TimeEdit

            BlobBaseEdit

                ImageEdit

                MemoExEdit

            CalcEdit

            ColorEdit

            DateEdit

            PopupBaseAutoSearchEdit

                ComboBoxEdit           

                LookUpEditBase

                         LookUpEdit

                         TreeListLookUpEdit

                         GridLookUpEditBase

                                   GridLookUpEdit

                                   SearchLookUpEdit

            PopupContainerEdit

                　　CheckedComboBoxEdit

                　　ResourcesPopupCheckedListBoxControl

            PopupGalleryEdit

五、与.net基本的控件比较

1. 命名空间(NameSpace)

.net基本控件的类都在System.Windows.Forms的命名空间下，DevExpress的控件类在DevExpress命名空间下

2. 可以代替.net的控件

DevExpress的大部分控件都已可以代替.net的基本控件。如:

• 按钮:
  System.Windows.Forms.Button -> DevExpress.XtraEditors.SimpleButton
• 文本框:
  System.Windows.Forms.TextBox -> DevExpress.XtraEditors.TextEdit
• 复选框
  System.Windows.Forms.CheckBox -> DevExpress.XtraEditors.CheckEdit
• 下拉框:
  System.Windows.Forms.ComboBox -> DevExpress.XtraEditors.ComboBoxEdit
• 日 期:
  System.Windows.Forms.DateTimePicker -> DevExpress.XtraEditors.DateEdit   /   DevExpress.XtraEditors.TimeEdit

这里就不一一列举了,认真看看，相信一定找出很多可以替代的控件

六、几个比较重要、常用的属性

1：EditValue

DevExpress.XtraEditors.*Edit 的控件都不可少的一个EditValue属性。

如:DevExpress.XtraEditors.*Edit

通常,EditValue会跟Text的值是一样的。

只是EditValue的类型为Object,

而Text的属性为String,

也就是EditValue通常可以代替Text属性。

2. Enable 和 Visable

是否禁用和是否可见

3. Properties

设置控件一些特征

例如 是否只读:
textEdit.Properties.ReadOnly = true;

不允许获得焦点
textEdit.Properties.AllowFocused = false;

禁止空值输入
textEdit.Properties.AllowNullInput = false;

// 当这个属性应用在TimeEdit中，它的清除按钮，将会禁用（灰掉）

禁止编辑器输入
comboBoxEdit.Properties.TextEditStyle = DevExpress.XtraEditors.Controls.TextEditStyles.DisableTextEditor;// 只选模式，不能输入文本

4. Appearance 设置风格。

Dexpress把所有设置控件风格的特性都放到Appearance属性下。
例:

//前景色
simpleButton.Appearance.ForeColor = Color.Red;

//背景色
simpleButton.Appearance.BackColor = Color.Red;

Appearance.TextOptions 文本对齐操作

// 居中对齐
simpleButton.Appearance.TextOptions.HAlignment = DevExpress.Utils.HorzAlignment.Center;

// 自动换行。当控件的宽度容不下文本的长度，会自动换行。
simpleButton.Appearance.TextOptions.WordWrap = DevExpress.Utils.WordWrap.Wrap;

注意:

在某些控件中, Properties属性下才有Apperarance
DevExpress.XtraEditors.TextEdit  textEdit =  …;
textEdit.Properties.Appearance.ForeColor = Color.Red;

七. 几个常用的控件

1:LookUpEdit

用强大的LookUpEdit代替ComboBox

• ComboBox不支持数据绑定
• 由于DevExpress的ComboBox天生存在数据绑定缺陷，

所以有时我们要做数据绑定这种杀鸡小事时，不得不使用牛刀LooUpEdit。

如下代码，可用实现一个ComboBox:

// 禁止文本输入
this.lookUpEdit1.Properties.TextEditStyle = DevExpress.XtraEditors.Controls.TextEditStyles.DisableTextEditor;
// 默认为null的显示
this.lookUpEdit1.Properties.NullText = "[请选择类别]";
// 加入一个显示列
this.lookUpEdit1.Properties.Columns.Add(new DevExpress.XtraEditors.Controls.LookUpColumnInfo("Name"));
// 不显示页眉（包括列头）
this.lookUpEdit1.Properties.ShowHeader = false;
// 不显示页脚（包括关闭按钮）
this.lookUpEdit1.Properties.ShowFooter = false;
// 要显示的字段,Text获得
this.lookUpEdit1.Properties.DisplayMember = "Name";
// 实际值的字段,EditValue获得
this.lookUpEdit1.Properties.ValueMember = "Value";
// 数据绑定 
ICollection list = Global.ClassCategoryList;
// 绑定数据
this.lookUpEdit1.Properties.DataSource = list;
// 设置行数(根据这个自动设置高度)
this.lookUpEdit1.Properties.DropDownRows = list.Count;

​2. GridControl

GridControl可以代替.net的System.Windows.Forms.DataGrid控件。
GirdControl只是一个容器控件,必须要求GridView视图作为它的子控件。
GridControl可以包含多个视图，可以实现视图的切换。

每个GridView视图必须包含列(Column)
GridControl支持层级视图

GridControl 经常设置的属性

使用导航器

this.gridControl1.UseEmbeddedNavigator = true;

this.gridControl1.EmbeddedNavigator.Buttons.Append.Visible = false;
this.gridControl1.EmbeddedNavigator.Buttons.CancelEdit.Visible = false;
this.gridControl1.EmbeddedNavigator.Buttons.Edit.Visible = false;
this.gridControl1.EmbeddedNavigator.Buttons.EndEdit.Visible = false;
this.gridControl1.EmbeddedNavigator.Buttons.Remove.Visible = false;

this.gridControl1.EmbeddedNavigator.Buttons.First.Visible = true;
this.gridControl1.EmbeddedNavigator.Buttons.Last.Visible = true;
this.gridControl1.EmbeddedNavigator.Buttons.Next.Visible = true;
this.gridControl1.EmbeddedNavigator.Buttons.NextPage.Visible = true;
this.gridControl1.EmbeddedNavigator.Buttons.Prev.Visible = true;
this.gridControl1.EmbeddedNavigator.Buttons.PrevPage.Visible = true;

GridView 经常设置的属性

// 禁止编辑
this.gridView1.OptionsBehavior.Editable = false;

// 不允许使用过滤
this.gridView1.OptionsCustomization.AllowFilter = false;

// 不允许使用排序
this.gridView1.OptionsCustomization.AllowSort = false;

// 不显示组面板
this.gridView1.OptionsView.ShowGroupPanel = false;

// 如果宽度溢出，自动出现滚动条

this.gridView1.OptionsView.ColumnAutoWidth =true;

// 禁止单元格获得焦点
this.gridView1.OptionsSelection.EnableAppearanceFocusedCell = false;

// 选择的行背景透明
this.gridView1.Appearance.SelectedRow.BackColor = Color.Transparent;

---

事件

//订阅行焦点改变事件
this.gridView1.FocusedRowChanged += new DevExpress.XtraGrid.Views.Base.FocusedRowChangedEventHandler(this.gridView1_FocusedRowChanged);

//验证编辑器（单元格）值输入
this.gridView1.ValidatingEditor += new DevExpress.XtraEditors.Controls.BaseContainerValidateEditorEventHandler(this.gridView1_ValidatingEditor);

private void gridView1_ValidatingEditor(object sender, DevExpress.XtraEditors.Controls.BaseContainerValidateEditorEventArgs e)
{
 if (gridView1.FocusedColumn == col产品名称)
 {
     if (string.IsNullOrEmpty(e.Value as string)) {
         e.ErrorText = "产品名称不能为空";
         e.Valid = false;
     }
 }
}

​​

//订阅设置行风格事件
this.gridView1.RowStyle += new DevExpress.XtraGrid.Views.Grid.RowStyleEventHandler(this.gridView1_RowStyle);

private void gridView1_RowStyle(object sender, DevExpress.XtraGrid.Views.Grid.RowStyleEventArgs e)
{
 object value = gridView1.GetRowCellValue(e.RowHandle, "中止");
 if (value!=null&&(bool)value) {
 e.Appearance.ForeColor = Color.Red;
 }
}

this.gridView1.CustomColumnDisplayText += new DevExpress.XtraGrid.Views.Base.CustomColumnDisplayTextEventHandler(this.gridView1_CustomColumnDisplayText);

private DataTable _CategoryList;

public DataTable CategoryList {
 get {
 if (_CategoryList == null) {
 _CategoryList=GetData("select * from 产品类别");
 DataColumn pk = _CategoryList.Columns["类别ID"];
 _CategoryList.PrimaryKey = new DataColumn[] {pk};
 }
 return _CategoryList;
 }
}

private void gridView1_CustomColumnDisplayText(object sender, DevExpress.XtraGrid.Views.Base.CustomColumnDisplayTextEventArgs e)
{
 if (e.Column.Name == "col类别ID") {
 e.DisplayText = CategoryList.Rows.Find(e.Value)["类别名称"] as string;
 }
}

// 行单元格对齐
this.gridView1.RowCellDefaultAlignment += new DevExpress.XtraGrid.Views.Base.RowCellAlignmentEventHandler(this.gridView1_RowCellDefaultAlignment);

private void gridView1_RowCellDefaultAlignment(object sender, DevExpress.XtraGrid.Views.Base.RowCellAlignmentEventArgs e)
{
 e.HorzAlignment = DevExpress.Utils.HorzAlignment.Near;
}

3. 界面操作

3.1 根据条件操作行或列风格

3.2 添加RepositoryItem(内嵌元素In-place EditorRepository)

3.3 列汇总

首先,设置this.gridView1.OptionsView.ShowFooter = true;

this.col库存量.SummaryItem.DisplayFormat = “总量:{0}”;

// 六种:Sum,Average,Count,Max,Min,Custom
col单位数量.SummaryItem.SummaryType = DevExpress.Data.SummaryItemType.Sum;