GroupControl.CustomButtonChecked Event

Occurs whenever a check button from the GroupControl.CustomHeaderButtons collection is checked.

Namespace: DevExpress.XtraEditors

Assembly: DevExpress.Utils.v24.1.dll

NuGet Packages: DevExpress.Utils, DevExpress.Wpf.Core

Declaration

C#

[DXCategory("Behavior")]
public virtual event BaseButtonEventHandler CustomButtonChecked

VB.NET

<DXCategory("Behavior")>
Public Overridable Event CustomButtonChecked As BaseButtonEventHandler

Event Data

The CustomButtonChecked event's data class is DevExpress.XtraBars.Docking2010.BaseButtonEventArgs.

Remarks

The following example demonstrates how to determine which header button has been checked/unchecked:

C#

using DevExpress.XtraBars.Docking2010;
using DevExpress.XtraEditors.ButtonsPanelControl;

public Form1() {
    InitializeComponent();
    groupControl1.CustomButtonChecked += groupControl1_CustomButtonChecked;
    groupControl1.CustomButtonUnchecked += groupControl1_CustomButtonUnchecked;
}
private void groupControl1_CustomButtonChecked(object sender, BaseButtonEventArgs e) {
    MessageBox.Show(String.Format("{0} was checked", (e.Button as GroupBoxButton).Caption), "Information", MessageBoxButtons.OK);
}
private void groupControl1_CustomButtonUnchecked(object sender, BaseButtonEventArgs e) {
    MessageBox.Show(String.Format("{0} was unchecked", (e.Button as GroupBoxButton).Caption), "Information", MessageBoxButtons.OK);
}

VB.NET

Imports DevExpress.XtraBars.Docking2010
Imports DevExpress.XtraEditors.ButtonsPanelControl

Public Sub New()
    InitializeComponent()
    AddHandler groupControl1.CustomButtonChecked, AddressOf groupControl1_CustomButtonChecked
    AddHandler groupControl1.CustomButtonUnchecked, AddressOf groupControl1_CustomButtonUnchecked
End Sub
Private Sub groupControl1_CustomButtonChecked(ByVal sender As Object, ByVal e As BaseButtonEventArgs)
    MessageBox.Show(String.Format("{0} was checked", (TryCast(e.Button, GroupBoxButton)).Caption), "Information", MessageBoxButtons.OK)
End Sub
Private Sub groupControl1_CustomButtonUnchecked(ByVal sender As Object, ByVal e As BaseButtonEventArgs)
    MessageBox.Show(String.Format("{0} was unchecked", (TryCast(e.Button, GroupBoxButton)).Caption), "Information", MessageBoxButtons.OK)
End Sub