HeaderClickAction Property

Gets/sets the action performed when the header is clicked. Note, this does not affect the behavior of the expansion indicator.

Syntax

Visual Basic

'Declaration
 
Public Property HeaderClickAction As GroupBoxHeaderClickAction

C#

public GroupBoxHeaderClickAction HeaderClickAction {get; set;}

Remarks

This property can be set to one of the three GroupBoxHeaderClickAction values. The default value of this property is 'Default', which means that the action taken in response to a header click is determined by the value of the ExpansionIndicator property. If that property is set to 'None' then a click anywhere on the header will toggle the groupbox's expanded state. If an expansion indicator does exist then the default action is to do nothing (the expanded state is unaffected) in response to a click on the header. If this property is set to 'ToggleExpansion' then a click on either the header or expansion indicator will change the expanded state of the control.

Example

This snippet shows a couple of expansion-related settings of the UltraExpandableGroupBox.

Visual Basic

Imports Infragistics.Win.Misc

Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles MyBase.Load

    Me.UltraExpandableGroupBox1.ViewStyle = GroupBoxViewStyle.Office2003

    ' Display the expansion indicator on the side of the header which is furthest
    ' from the upper-left corner of the control.  If the header is horizontal then the
    ' expansion indicator will appear on the right side of the header, else if the header
    ' is vertical it will appear on the bottom.
    Me.UltraExpandableGroupBox1.ExpansionIndicator = GroupBoxExpansionIndicator.Far

    ' Allow a click anywhere on the header to change the expanded state of the control.  Clicks
    ' on the expansion indicator will still toggle expansion when using this mode.
    Me.UltraExpandableGroupBox1.HeaderClickAction = GroupBoxHeaderClickAction.ToggleExpansion

End Sub

C#

using Infragistics.Win.Misc;

private void Form1_Load(object sender, System.EventArgs e)
{
	this.ultraExpandableGroupBox1.ViewStyle = GroupBoxViewStyle.Office2003;

	// Display the expansion indicator on the side of the header which is furthest
	// from the upper-left corner of the control.  If the header is horizontal then the
	// expansion indicator will appear on the right side of the header, else if the header
	// is vertical it will appear on the bottom.
	this.ultraExpandableGroupBox1.ExpansionIndicator = GroupBoxExpansionIndicator.Far;

	// Allow a click anywhere on the header to change the expanded state of the control.  Clicks
	// on the expansion indicator will still toggle expansion when using this mode.
	this.ultraExpandableGroupBox1.HeaderClickAction = GroupBoxHeaderClickAction.ToggleExpansion;
}

Requirements

Target Platforms: Windows 10, Windows 8.1, Windows 8, Windows 7, Windows Server 2012, Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2