ActionBase.CustomizeControl Event
Occurs after the control is initialized. Allows customizing the default control settings.
Namespace: DevExpress.ExpressApp.Actions
Assembly: DevExpress.ExpressApp.v18.2.dll
Declaration
public event EventHandler<CustomizeControlEventArgs> CustomizeControl
Public Event CustomizeControl As EventHandler(Of CustomizeControlEventArgs)
Event Data
Do not handle this event for a built-in Action in a View or Window Controller's OnActivated method because this method is called after the Action controls creation. Use the OnFrameAssigned method instead.
The CustomizeControlEventArgs.Control event parameter returns the Action Item object which provides access to the control settings. See all of the possible scenarios in the Action section of the Feature Center demo that is installed in the %PUBLIC%\Documents\DevExpress Demos 18.2\Components\eXpressApp Framework\FeatureCenter folder by default, or refer to the Feature Center demo online. The lists below show which type of Action Item is returned for different Action types.
ASP.NET Specific Scenarios
SimpleAction
Returned value type:
myAction.CustomizeControl += (s, e) => {
SimpleActionMenuActionItem actionItem = e.Control as SimpleActionMenuActionItem;
// or
ASPxGridViewCustomButtonInitializer initializer = e.Control as ASPxGridViewCustomButtonInitializer;
//...
}
AddHandler myAction.CustomizeControl, Sub(s, e)
Dim actionItem As SimpleActionMenuActionItem = TryCast(e.Control, SimpleActionMenuActionItem)
' or
Dim initializer As ASPxGridViewCustomButtonInitializer = TryCast(e.Control, ASPxGridViewCustomButtonInitializer)
'...
End Sub
SingleChoiceAction menu Actions.
The returned value type depends on the SingleChoiceAction.ItemType property value and ChoiceActionItems sub items:
- SingleChoiceActionAsModeMenuActionItem;
- SingleChoiceActionItemAsHierarchicalModeActionMenuItem;
- SingleChoiceActionItemAsOperationActionMenuItem.
myAction.CustomizeControl += (s, e) => {
SingleChoiceActionAsModeMenuActionItem actionItem = e.Control as SingleChoiceActionAsModeMenuActionItem;
// or
SingleChoiceActionItemAsHierarchicalModeActionMenuItem actionItem = e.Control as SingleChoiceActionItemAsHierarchicalModeActionMenuItem;
// or
SingleChoiceActionItemAsOperationActionMenuItem actionItem = e.Control as SingleChoiceActionItemAsOperationActionMenuItem;
//...
}
AddHandler myAction.CustomizeControl, Sub(s, e)
Dim actionItem As SingleChoiceActionAsModeMenuActionItem = TryCast(e.Control, SingleChoiceActionAsModeMenuActionItem)
' or
Dim actionItem As SingleChoiceActionItemAsHierarchicalModeActionMenuItem = TryCast(e.Control, SingleChoiceActionItemAsHierarchicalModeActionMenuItem)
' or
Dim actionItem As SingleChoiceActionItemAsOperationActionMenuItem = TryCast(e.Control, SingleChoiceActionItemAsOperationActionMenuItem)
'...
End Sub
ShowNavigationItem Action returned by the ShowNavigationItemController.ShowNavigationItemAction property.
Returned value type:
Frame.GetController<ShowNavigationItemController>().ShowNavigationItemAction.CustomizeControl += (s, e) => {
ASPxNavBar navBar = e.Control as ASPxNavBar;
// or
ASPxTreeView treeView = e.Control as ASPxTreeView;
//...
}
AddHandler Frame.GetController(Of ShowNavigationItemController)().ShowNavigationItemAction.CustomizeControl, Sub(s, e)
Dim navBar As ASPxNavBar = TryCast(e.Control, ASPxNavBar)
' or
Dim treeView As ASPxTreeView = TryCast(e.Control, ASPxTreeView)
'...
End Sub
ParametrizedAction.
Returned value type is ParametrizedActionMenuActionItem.
myAction.CustomizeControl += (s, e) => {
ParametrizedActionMenuActionItem actionItem = e.Control as ParametrizedActionMenuActionItem;
//...
}
AddHandler myAction.CustomizeControl, Sub(s, e)
Dim actionItem As ParametrizedActionMenuActionItem = TryCast(e.Control, ParametrizedActionMenuActionItem)
'...
End Sub
PopupWindowShowAction.
Returned value type:
myAction.CustomizeControl += (s, e) => {
PopupWindowActionMenuActionItem actionItem = e.Control as PopupWindowActionMenuActionItem;
// or
ASPxGridViewCustomButtonInitializer actionItem = e.Control as ASPxGridViewCustomButtonInitializer;
//...
}
AddHandler myAction.CustomizeControl, Sub(s, e)
Dim actionItem As PopupWindowActionMenuActionItem = TryCast(e.Control, PopupWindowActionMenuActionItem)
' or
Dim initializer As ASPxGridViewCustomButtonInitializer = TryCast(e.Control, ASPxGridViewCustomButtonInitializer)
'...
End Sub
WinForms Specific Scenarios
See Also
We are updating the DevExpress product documentation website and this page is part of our new experience. During this transition period, product documentation remains available in our previous format at documentation.devexpress.com. Learn More...