DevExpress 控件学习记录1

一、 自定义单元格显示文本

有时候需要对原始数据代码做些自定义显示文本处理（例如0[失败]，1[成功]）,可以在数据库查询时，对数据进行转换。这里使用DevExpress 控件时，有对应的事件可以处理这个操作。
DevExpress 中提供CustomColumnDisplayText 事件，可以处理数据渲染时显示的文本：

双击之后，会自动生成如下事件：

private void gridView1_CustomColumnDisplayText(object sender, DevExpress.XtraGrid.Views.Base.CustomColumnDisplayTextEventArgs e)
{
	// 具体实现
}

CustomColumnDisplayText 事件中有两个入参，sender和e。

参数	含义
sender	1. 代表了触发该事件的对象，也就是触发了CustomColumnDisplayText事件的GridView控件本身，可以通过这个参数访问GridView控件的相关属性和方法。一般都是通过GridView的实例（gridView1）直接访问。2. 可以对sender参数进行类型转换，以根据自己的需求来进行操作。常用转换未GridView，DevExpress.XtraGrid.Views.Grid.GridView view = sender as DevExpress.XtraGrid.Views.Grid.GridView
e	参数e 包含了事件的具体信息，可以通过e 修改事件的行为。 在CustomColumnDisplayText事件中，有如下几个重要属性:1. e.Column: 表示当前事件关联的列对象。通过这个属性，可以知道是哪个列触发了自定义显示文本的需求。可以使用e.Column.FieldName（字段名）来指定相应的行。2.e.DisplayText: 代表最终将被渲染到单元格中的文本了。3.e.value: 获取当前单元格的值(e.Value 不会直接暴露出来，就是没法e.出来，一般会使用gridView.GetRowCellValue方法获取)。

之后，可以编写CustomColumnDisplayText事件的具体实现：

		private void gridView1_CustomColumnDisplayText(object sender, DevExpress.XtraGrid.Views.Base.CustomColumnDisplayTextEventArgs e)
        {
            if (e.Column.FieldName == "FieldName")
            {
                var valueStr = Convert.ToString(e.Value);  // 
                if (!string.IsNullOrEmpty(valueStr))
                {
                    if (valueStr == "N")
                    {
                        e.DisplayText = "失败";
                    }
                    else if (valueStr == "Y")
                    {
                        e.DisplayText = "成功";
                    }
                    else 
                    {
                    	e.DisplayText = "异常";
                    }
                }
            }
        }

二、自定义单元格外观

单纯的自定义文本显示，可能在数据展示上能到达到需求，但是当不同类型的情况比较多时，就无法在UI上突出表现出特殊情况（或者需要突出显示的情况）。可以自定义指定单元格的外观，使用DevExpress控件中的RowCellStyle 事件实现：

双击之后，会自动生成如下事件：

		private void gridView1_RowCellStyle(object sender, DevExpress.XtraGrid.Views.Grid.RowCellStyleEventArgs e)
		{
			// 具体事项
		}

在一中，使用e.Value 回去单元格的值，其实存在异议。下面将使用另外一种方式获取单元格的值。
具体实现：

		private void gridView1_RowCellStyle(object sender, DevExpress.XtraGrid.Views.Grid.RowCellStyleEventArgs e)
        {
            if (e.RowHandle >= 0 && (e.Column.FieldName == "FieldName"))
            {                
                DevExpress.XtraGrid.Views.Grid.GridView view = sender as DevExpress.XtraGrid.Views.Grid.GridView;
                string statusValue = view.GetRowCellValue(e.RowHandle, "FieldName").ToString();
                if (statusValue == "N")
                {
                    e.Appearance.ForeColor = Color.Red; // 设置单元格的前景色
                }
            }
        }

属性&方法	说明
GetRowCellValue(int rowHandle, string fieldName)	返回指定单元格的值，该值由网格数据源中的行句柄rowHandle和字段名fieldName标识。
e.RowHandle	表示当前事件关联的行句柄。可以获取或修改特定行的数据。
e.Appearance	含义正如Appearance表达的一样，可以用来获取或设置外观，里面具体项可以.出来看，或者在设计器中查看(如下图显示)