Public ReadOnly Property HeaderState As HeaderState

public HeaderState HeaderState {get;}

プロパティ値

HeaderStateプロパティの値を調べると、すべての項目のチェック状態または有効状態がすぐにわかります。

• 値がHeaderState.Checkedの場合は、すべての項目のチェックボックスがオンであるか（GcCheckedGroupBox.HeaderTypeがHeaderType.CheckerAndTextの場合）、有効状態である（GcCheckedGroupBox.HeaderTypeおよびGcRadioGroupBox.HeaderTypeがHeaderType.EnablerAndTextの場合）ことを示します。
• 値がHeaderState.Uncheckedの場合は、すべての項目のチェックボックスがオフであるか（GcCheckedGroupBox.HeaderTypeがHeaderType.CheckerAndTextの場合）、無効状態である（GcCheckedGroupBox.HeaderTypeおよびGcRadioGroupBox.HeaderTypeがHeaderType.EnablerAndTextの場合）ことを示します。
• 値がHeaderState.Indeterminateの場合は、一部の項目のチェックボックスがオンであるか（GcCheckedGroupBox.HeaderTypeがHeaderType.CheckerAndTextの場合）、有効状態である（GcCheckedGroupBox.HeaderTypeおよびGcRadioGroupBox.HeaderTypeがHeaderType.EnablerAndTextの場合）ことを示します。

また、GcCheckedGroupBox.HeaderTypeおよびGcRadioGroupBox.HeaderTypeがHeaderType.ExpanderAndTextの場合は、HeaderStateプロパティの値から、GcCheckedGroupBoxまたはGcRadioGroupBoxが展開されているかどうかがわかります。

• 値がHeaderState.Expandedの場合、GcCheckedGroupBoxコントロールまたはGcRadioGroupBoxコントロールは展開されています。
• 値がHeaderState.Collapsedの場合、GcCheckedGroupBoxコントロールまたはGcRadioGroupBoxコントロールは折りたたまれています。

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

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 メンバ
HeaderStateChange イベント
OnHeaderStateChange メソッド
HeaderStateChange イベント
OnHeaderStateChange メソッド