3.AutoFilterCellEditorInitialize (1)语法:
public delegatevoid ASPxGridViewEditorEventHandler(object sender,ASPxGridViewEditorEventArgse);
ASPxGridViewEditorEventArgs类包括以下属性:
Column:GridViewDataColumn类型,只读。栏位实例。 Editor:ASPxEditBase类型,只读。编辑器实例。 KeyValue:object类型。只读。关键栏位值。 Value:object类型。只读。过滤栏位值。 VisibleIndex:int类型。只读。行号。
(2)英文说明:
Enables the cell editors displayed within theauto filter row cells to be initialized.
(3)触发条件:必须显示了自动过滤工具条 要显示自动过滤行应该做如下设置:
this.ASPxGridView1.Settings.ShowFilterBar= DevExpress.Web.ASPxGridView.GridViewStatusBarMode.Visible;//显示自动过滤工具条
this.ASPxGridView1.Settings.ShowFilterRow= true;//显示自动过滤行
(4)中文说明:允许程序员为过滤行栏位指定显示格式。
该事件是在AutoFilterCellEditorCreate事件后执行的,可以在此事件中覆盖AutoFilterCellEditorCreate事件中所指定的属性。 例:
switch (e.Column.FieldName) {
case\
e.Editor.BackColor = System.Drawing.Color.Yellow; break; default: break; }
4.BeforeGetCallbackResult
(1)语法:public delegate void EventHandler(object sender, EventArgse);
(2)英文说明:
Occurs after a callback, when the ASPxGridView is loaded,but prior to rendering.
(3)触发条件:调用AspxGridView客户端方法GetValuesOnCustomCallback。
(4)中文说明:发生在ASPxGridView已装载但未呈现时获取回调结果。
5.BeforePerformDataSelect
(1)语法:publicdelegate void EventHandler(object sender, EventArgs e);
(2)英文说明:Occursbefore the ASPxGridView control obtains data from a data source. (3)触发条件:绑定数据时。
(4)中文说明:发生在ASPxGridView从数据源中获取数据之前。 通常在主从模式下用于给明细AspxGridView的数据检索参数赋值。 例:
Session[\//Session[\为明细AspxGridView的数据源参数
6.CancelRowEditing
(1)语法:public delegatevoid ASPxStartRowEditingEventHandler(object sender, ASPxStartRowEditingEventArgse);
ASPxStartRowEditingEventArgs类包括以下属性: Cancel:bool类型。可读写。
(2)英文说明:Enables you to preventchanges made within a row from being discarded. (3)触发条件:用户点击内置的【取消】按钮或调用CancelEdit()方法时。 (4)中文说明:取消行编辑状态前事件。
可以在该事件中阻止用户将编辑状态转换为浏览状态。(设置e.Cancel=true)例如弹出对话框提醒用户是否确实需要取消编辑状态或清除在编辑过程中缓存的数据。
7. CellEditorInitialize
(1)语法:publicdelegate void ASPxGridViewEditorEventHandler(object sender, ASPxGridViewEditorEventArgse);
ASPxGridViewEditorEventArgs类包括以下属性:
Column:GridViewDataColumn类型,只读。栏位实例。 Editor:ASPxEditBase类型,只读。编辑器实例。 KeyValue:object类型。只读。主键栏位值。 Value:object类型。只读。过滤栏位值。 VisibleIndex:int类型。只读。行号。
(2)英文说明:Enables the cell editorsdisplayed within the edit cells to be initialized. (3)触发条件:发生在行数据状态由浏览状态改为编辑状态时。 (4)中文说明:栏位编辑器初始化事件。
8. ClientLayout (1)语法:
publicdelegate void ASPxClientLayoutHandler(object sender,ASPxClientLayoutArgse);
ASPxClientLayoutArgs类包括以下属性:
LayoutData:string类型,可读写。布局数据。
LayoutMode:ClientLayoutMode类型(枚举)。只读。布局模式。取值范围:Loading、Saving.
(2)英文说明:
Enables you to save and restore the previously savedlayout of the ASPxGridView. (3)触发条件:在调用SaveLayout()保存布局或LoadLayout()装载布局时触发该事件。 (4)中文说明:允许你保存布局或装载之前的布局。
9. CustomButtonCallback (1)语法:
publicdelegate void ASPxGridViewCustomButtonCallbackEventHandler( objectsender,ASPxGridViewCustomButtonCallbackEventArgs e);
ASPxGridViewCustomButtonCallbackEventArgs类包括以下属性: ButtonID:string类型,只读。按钮名称。 VisibleIndex: int类型。只读。行号。
(2)英文说明:Occurs when a custom command button has been clicked. (3)触发条件:点击自定义按钮时触发。 (4)中文说明:该事件不能只在页面IsPostBack=false的情况下声明,否则无法触发。 自定义按钮可以在
通常在该事件中捕获按钮名称调用对应方法作出实际的回应。 例:
string id = e.ButtonID; switch (id) {
case\
this.ASPxGridView1.Selection.SelectRow(e.VisibleIndex); break; default: break; }
10. CustomCallback
(1)语法:
publicdelegate void ASPxGridViewCustomCallbackEventHandler(object sender,ASPxGridViewCustomCallbackEventArgs e);
ASPxGridViewCustomCallbackEventArgs类包括以下属性: Parameters:string类型,只读。所有自定义参数值。 (2)英文说明:
Fires when a round tripto the server has been initiated by a call to the clientASPxClientGridView.PerformCallback method.
(3)触发条件:调用客户端PerformCallback方法时触发。 (4)中文说明:该事件不能只在页面IsPostBack=false的情况下声明,否则无法触发。事件参数ASPxGridViewCustomCallbackEventArgs.Parameters由程序员负责解释。
例: //自定义回调事件
protected void ASPxGridView1_CustomCallback(object sender,ASPxGridViewCustomCallbackEventArgs e) {
if(e.Parameters.Length > 0) {
intvisibleIndex = 0;
string[]parameterList = e.Parameters.Split('|');//取参数列表 if(parameterList.Length > 0) {
switch(parameterList[0].ToString().ToLower()) {
case\新增
this.ASPxGridView1.AddNewRow(); break;
case\修改 if(parameterList.Length >= 2) {
if (Int32.TryParse(parameterList[1], out visibleIndex)) {
this.ASPxGridView1.StartEdit(visibleIndex); } } break; default: break; } }? } }
前台代码示例:
Grid.PerformCallback('AddNewRow') Grid.PerformCallback('StartEdit|2')
11. CustomColumnDisplayText (1)语法:
publicdelegate void ASPxGridViewColumnDisplayTextEventHandler(object sender, ASPxGridViewColumnDisplayTextEventArgse);
ASPxGridViewColumnDisplayTextEventArgs类包括以下属性: Column:GridViewDataColumn类型,只读。栏位实例。 DisplayText:string类型。可读写。显示文本。 Value:object类型。可读写。栏位值。 VisibleRowIndex:int类型。只读。行号。
ASPxGridViewColumnDisplayTextEventArgs类包括以下方法: object GetFieldValue(stringfieldName):获取栏位值。
object GetFieldValue(intvisibleRowIndex, string fieldName) :获取栏位值。 (2)英文说明:Enables custom displaytext to be provided for any cell.
(3)触发条件:发生在栏位绑定或取消绑定时。
(4)中文说明:允许你自定义每个单元格的显示文本。比如在数据导出时将栏位值为0改为空值。
12. CustomColumnGroup (1)语法:
publicdelegate void ASPxGridViewCustomColumnSortEventHandler(object sender,CustomColumnSortEventArgs e);
CustomColumnSortEventArgs类包括以下属性:
Column:GridViewDataColumn类型,可读写。栏位实例。 Handled:bool类型。可读写。是否已处理。
ListSourceRowIndex1:int类型,只读。来源行号1。 ListSourceRowIndex2:int类型,只读。来源行号2。
Result:int类型,可读写。分组结果。0表示划入同一组,1或-1表示划入不同组。 SortOrder:ColumnSortOrder类型(枚举),只读。排序方式。 Value1:object类型,只读。值1. Value2:object类型,只读。值2.
ASPxGridViewColumnDisplayTextEventArgs类包括以下方法: objectGetRow1Value(string fieldName):获取来源行1的值。 object GetRow2Value(stringfieldName):获取来源行2的值。
(2)英文说明:Provides the ability togroup data using custom rules.