Back to Devexpress

GroupControl.CustomButtonChecked Event

windowsforms-devexpress-dot-xtraeditors-dot-groupcontrol-fb7213b2.md

latest3.1 KB
Original Source

GroupControl.CustomButtonChecked Event

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

Namespace : DevExpress.XtraEditors

Assembly : DevExpress.Utils.v25.2.dll

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

Declaration

csharp
[DXCategory("Behavior")]
public virtual event BaseButtonEventHandler CustomButtonChecked
vb
<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:

csharp
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
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

See Also

CustomHeaderButtons

GroupControl Class

GroupControl Members

DevExpress.XtraEditors Namespace