ActionControlsSiteController.CustomizeActionControl Event

Occurs when an Action control is created.

Namespace: DevExpress.ExpressApp.SystemModule

Assembly: DevExpress.ExpressApp.v24.2.dll

NuGet Package: DevExpress.ExpressApp

Declaration

C#

public event EventHandler<ActionControlEventArgs> CustomizeActionControl

VB.NET

Public Event CustomizeActionControl As EventHandler(Of ActionControlEventArgs)

Event Data

The CustomizeActionControl event's data class is DevExpress.ExpressApp.SystemModule.ActionControlEventArgs.

Remarks

Important

This event is designed to support the internal XAF infrastructure and should not be handled in your code. Use the ActionBase.CustomizeControl event instead.

Below is an example of how to handle this event to customize the created control properties.

C#

using DevExpress.ExpressApp;
using DevExpress.ExpressApp.SystemModule;
using DevExpress.XtraBars;
using DevExpress.XtraEditors.Repository;
// ...
public class CustomizeActionControlController : WindowController {
    protected override void OnActivated() {
        base.OnActivated();
        Frame.GetController<ActionControlsSiteController>().CustomizeActionControl +=
            ActionControlsSiteController_CustomizeActionControl;
    }
    protected override void OnDeactivated() {
        Frame.GetController<ActionControlsSiteController>().CustomizeActionControl -=
           ActionControlsSiteController_CustomizeActionControl;
        base.OnDeactivated();
    }
    private void ActionControlsSiteController_CustomizeActionControl(object sender, ActionControlEventArgs e) {
        if (e.ActionControl.ActionId == "MyDateFilter") {
            BarEditItem barItem = (BarEditItem)e.ActionControl.NativeControl;
            barItem.Width = 170;
            RepositoryItemDateEdit repositoryItem = (RepositoryItemDateEdit)barItem.Edit;
            repositoryItem.Mask.UseMaskAsDisplayFormat = true;
            repositoryItem.Mask.EditMask = "yyyy-MMM-dd";
        }
    }
}

VB.NET

Imports DevExpress.ExpressApp
Imports DevExpress.ExpressApp.SystemModule
Imports DevExpress.XtraBars
Imports DevExpress.XtraEditors.Repository
' ...
Public Class CustomizeActionControlController
    Inherits WindowController

    Protected Overrides Sub OnActivated()
        MyBase.OnActivated()
        AddHandler Frame.GetController(Of ActionControlsSiteController)().CustomizeActionControl, AddressOf ActionControlsSiteController_CustomizeActionControl
    End Sub
    Protected Overrides Sub OnDeactivated()
        RemoveHandler Frame.GetController(Of ActionControlsSiteController)().CustomizeActionControl, AddressOf ActionControlsSiteController_CustomizeActionControl
        MyBase.OnDeactivated()
    End Sub
    Private Sub ActionControlsSiteController_CustomizeActionControl(ByVal sender As Object, ByVal e As ActionControlEventArgs)
        If e.ActionControl.ActionId = "MyDateFilter" Then
            Dim barItem As BarEditItem = CType(e.ActionControl.NativeControl, BarEditItem)
            barItem.Width = 170
            Dim repositoryItem As RepositoryItemDateEdit = CType(barItem.Edit, RepositoryItemDateEdit)
            repositoryItem.Mask.UseMaskAsDisplayFormat = True
            repositoryItem.Mask.EditMask = "yyyy-MMM-dd"
        End If
    End Sub
End Class

Tip

If you need to create an alternate control rather than customize the default control’s properties, handle the ActionControlsSiteController.CustomAddActionControlToContainer and ActionControlsSiteController.CustomBindActionControlToAction events instead.