ItemCheckEventArgs.NewValue ItemCheckEventArgs.NewValue ItemCheckEventArgs.NewValue ItemCheckEventArgs.NewValue Property


項目のチェック ボックスをオン、オフ、未確定のいずれかに設定するかどうかを示す値を取得または設定します。Gets or sets a value indicating whether to set the check box for the item to be checked, unchecked, or indeterminate.

 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 値のいずれか 1 つ。One of the CheckState values.

次のコード例では、このメンバーの使用を示します。The following code example demonstrates the use of this member. 例では、イベント ハンドラーが発生するときに報告、CheckedListBox.ItemCheckイベント。In the example, an event handler reports on the occurrence of the CheckedListBox.ItemCheck event. このレポートでは、イベントが発生してデバッグに役立つについて説明します。This report helps you to learn when the event occurs and can assist you in debugging. 複数のイベントまたは頻繁に発生するイベントを報告する、交換を検討MessageBox.ShowConsole.WriteLineまたはメッセージを複数行に追加TextBoxします。To report on multiple events or on events that occur frequently, consider replacing MessageBox.Show with Console.WriteLine or appending the message to a multiline TextBox.

コード例を実行する型のインスタンスを含むプロジェクトに貼り付けることCheckedListBoxというCheckedListBox1します。To run the example code, paste it into a project that contains an instance of type CheckedListBox named CheckedListBox1. イベント ハンドラーに関連付けられていることを確認し、CheckedListBox.ItemCheckイベント。Then ensure that the event handler is associated with the CheckedListBox.ItemCheck event.

private void CheckedListBox1_ItemCheck(Object sender, ItemCheckEventArgs e) {

System.Text.StringBuilder messageBoxCS = new System.Text.StringBuilder();
messageBoxCS.AppendFormat("{0} = {1}", "Index", e.Index );
messageBoxCS.AppendFormat("{0} = {1}", "NewValue", e.NewValue );
messageBoxCS.AppendFormat("{0} = {1}", "CurrentValue", e.CurrentValue );
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.AppendFormat("{0} = {1}", "NewValue", e.NewValue)
    messageBoxVB.AppendFormat("{0} = {1}", "CurrentValue", e.CurrentValue)
    MessageBox.Show(messageBoxVB.ToString(),"ItemCheck Event")

End Sub


このプロパティでは、チェックの状態が変更する前に、指定した項目の新しいチェックの状態を判断することができます、CheckedListBoxコントロール。This property enables you to determine the new check state for the specified item before the check state is changed by the CheckedListBox control. イベント ハンドラーでこのプロパティを使用する新しいチェックの状態を判断するだけでなく、ItemCheck指定されている別のチェックの状態に状態を変更するイベントです。In addition to determining the new check state, you can use this property in an event handler for the ItemCheck event to change the state to a different check state than the one specified. たとえば、ユーザーには項目の隣にチェック マークが配置されている場合、CheckedListBoxを確認しているはチェックされませんが、アプリケーションの状態に基づいて、オーバーライドできますチェック マークの状態に変更前の設定または t をこのプロパティを設定してo 異なるチェックの状態。For example, if the user placed a check mark next to an item in the CheckedListBox that you have determined should not be checked based on the state of your application, you can override the change in the check mark state by setting this property to its previous setting or to a different check state.