HeaderStateChange イベント

グループボックスコントロールのヘッダの状態が変更されたときに発生します。

構文

Visual Basic (宣言)
C#

Public Event HeaderStateChange As EventHandler(Of HeaderStateChangeEventArgs)

public event EventHandler<HeaderStateChangeEventArgs> HeaderStateChange

イベントデータ

イベントハンドラが、このイベントに関連するデータを含む、HeaderStateChangeEventArgs 型の引数を受け取りました。次の HeaderStateChangeEventArgs プロパティには、このイベントの固有の情報が記載されます。

プロパティ	解説
CurrentState	変更後のHeaderStateを取得します。このイベントが発生したとき、ヘッダはすでに新しい状態になっています。
OriginalState	変更前のHeaderStateを取得します。

解説

HeaderStateChangeイベントは、ヘッダを操作したとき（ヘッダのチェックボックスのオン/オフ、ヘッダの展開/折りたたみなど）に加えて、GcCheckedGroupBox.HeaderTypeプロパティまたはGcRadioGroupBox.HeaderTypeプロパティを変更したときにも発生します。

使用例

次のサンプルコードは、HeaderStateChangeイベントで、HeaderTypeとHeaderStateの組み合わせを使用してすべての項目のチェックボックスがオンであるかオフであるかを確認し、表示テキストを更新する方法を示します。このサンプルコードを実行するには、System.Windows.Forms.Formプロジェクトを作成し、GcCheckedGroupBoxのインスタンスを追加して、以下のコードをプロジェクトに貼り付けます。そして、このイベントハンドラをHeaderStateChangeイベントに関連付けます。

C#
Visual Basic

private void GcCheckedGroupBox_HeaderStateChange(object sender, HeaderStateChangeEventArgs e)
{
    GcCheckedGroupBox gcCheckedGroupBox = sender as GcCheckedGroupBox;
    if (gcCheckedGroupBox.HeaderType == HeaderType.CheckerAndText)
    {
        if (gcCheckedGroupBox.HeaderState == HeaderState.Checked ||
            gcCheckedGroupBox.HeaderState == HeaderState.Indeterminate)
        {
            gcCheckedGroupBox.Text = "UnCheck All";
        }
        else
        {
            gcCheckedGroupBox.Text = "Check All";
        }
    }
}

Private Sub GcCheckedGroupBox_HeaderStateChange(ByVal sender As Object, ByVal e As HeaderStateChangeEventArgs)
    Dim gcCheckedGroupBox As GcCheckedGroupBox = TryCast(sender, GcCheckedGroupBox)
    If gcCheckedGroupBox.HeaderType = HeaderType.CheckerAndText Then
        If gcCheckedGroupBox.HeaderState = HeaderState.Checked OrElse gcCheckedGroupBox.HeaderState = HeaderState.Indeterminate Then
            gcCheckedGroupBox.Text = "UnCheck All"
        Else
            gcCheckedGroupBox.Text = "Check All"
        End If
    End If
End Sub

プラットフォーム

Target Platforms: 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

参照

GcGroupBoxControlBase クラス
 GcGroupBoxControlBase メンバ
 HeaderState プロパティ
 OnHeaderStateChange メソッド
 HeaderState プロパティ
 OnHeaderStateChange メソッド