ItemCheckEventArgs.NewValue 속성

정의

네임스페이스:
System.Windows.Forms
어셈블리:
System.Windows.Forms.dll
Source:
ItemCheckEventArgs.cs
Source:
ItemCheckEventArgs.cs
Source:
ItemCheckEventArgs.cs
Source:
ItemCheckEventArgs.cs
Source:
ItemCheckEventArgs.cs

항목을 선택하거나 선택 취소하거나 확정하지 않을 확인란을 설정할지 여부를 나타내는 값을 가져오거나 설정합니다.

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 하나입니다.

예제

다음 코드 예제에서는이 멤버의 사용을 보여 줍니다. 이 예제에서 이벤트 처리기는 이벤트의 발생을 보고합니다 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 옆에 확인 표시를 배치한 경우 애플리케이션의 상태에 따라 확인 표시 상태를 확인하지 않아야 합니다. 이 속성을 이전 설정 또는 다른 확인 상태로 설정하여 확인 표시 상태의 변경 내용을 재정의할 수 있습니다.

적용 대상

추가 정보