ItemCheckEventArgs.NewValue プロパティ

定義

名前空間:
System.Windows.Forms
アセンブリ:
System.Windows.Forms.dll

アイテムのチェック ボックスをオンにするか、オフにするか、不確定にするかを示す値を取得または設定します。

public:
 property System::Windows::Forms::CheckState NewValue { System::Windows::Forms::CheckState get(); void set(System::Windows::Forms::CheckState value); };
public System.Windows.Forms.CheckState NewValue { get; set; }
member this.NewValue : System.Windows.Forms.CheckState with get, set
Public Property NewValue As CheckState

プロパティ値

CheckState

CheckState値の 1 つ。

例

次のコード例は、このメンバーの使用方法を示しています。 この例では、イベント ハンドラーは、 CheckedListBox.ItemCheck イベントの発生を報告します。 このレポートは、イベントがいつ発生するかを学習するのに役立ち、デバッグに役立ちます。 複数のイベントや頻繁に発生するイベントについて報告するには、 MessageBox.Show を Console.WriteLine に置き換えるか、メッセージを複数行の TextBoxに追加することを検討してください。

コード例を実行するには、CheckedListBoxという名前の型のインスタンスを含むプロジェクトCheckedListBox1貼り付けます。 次に、イベント ハンドラーが CheckedListBox.ItemCheck イベントに関連付けられていることを確認します。

private void CheckedListBox1_ItemCheck(Object sender, ItemCheckEventArgs e) {

System.Text.StringBuilder messageBoxCS = new System.Text.StringBuilder();
messageBoxCS.AppendFormat("{0} = {1}", "Index", e.Index );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "NewValue", e.NewValue );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "CurrentValue", e.CurrentValue );
messageBoxCS.AppendLine();
MessageBox.Show(messageBoxCS.ToString(), "ItemCheck Event" );
}

Private Sub CheckedListBox1_ItemCheck(sender as Object, e as ItemCheckEventArgs) _ 
     Handles CheckedListBox1.ItemCheck

    Dim messageBoxVB as New System.Text.StringBuilder()
    messageBoxVB.AppendFormat("{0} = {1}", "Index", e.Index)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "NewValue", e.NewValue)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "CurrentValue", e.CurrentValue)
    messageBoxVB.AppendLine()
    MessageBox.Show(messageBoxVB.ToString(),"ItemCheck Event")

End Sub

注釈

このプロパティを使用すると、 CheckedListBox コントロールによってチェック状態が変更される前に、指定した項目の新しいチェック状態を確認できます。 新しいチェック状態を決定するだけでなく、 ItemCheck イベントのイベント ハンドラーでこのプロパティを使用して、指定された状態とは異なるチェック状態に状態を変更できます。 たとえば、アプリケーションの状態に基づいてチェックすべきでないと判断した CheckedListBox の項目の横にチェック マークを付けた場合、このプロパティを以前の設定または別のチェック状態に設定することで、チェック マーク状態の変更をオーバーライドできます。

適用対象

こちらもご覧ください