LabelEditEventArgs 클래스

아티클
08/21/2007

ListView.BeforeLabelEdit 및 ListView.AfterLabelEdit 이벤트에 데이터를 제공합니다.

네임스페이스: System.Windows.Forms
어셈블리: System.Windows.Forms(system.windows.forms.dll)

구문

‘선언
Public Class LabelEditEventArgs
    Inherits EventArgs
‘사용 방법
Dim instance As LabelEditEventArgs

public class LabelEditEventArgs : EventArgs

public ref class LabelEditEventArgs : public EventArgs

public class LabelEditEventArgs extends EventArgs

public class LabelEditEventArgs extends EventArgs

설명

LabelEditEventArgs는 ListViewItem의 인덱스 및 캡션과 사용자가 편집을 마친 후의 캡션을 지정합니다. 이 클래스는 CancelEdit 속성도 제공합니다. ListView.BeforeLabelEdit 이벤트 처리기에서 이 속성을 사용하여 사용자가 레이블을 편집하지 못하도록 할 수 있습니다. ListView.AfterLabelEdit 이벤트 처리기에서도 이 속성을 사용하여 변경을 취소하고 레이블을 원래 값으로 되돌릴 수 있습니다. 이 속성은 변경 내용을 커밋하기 전에 사용자 입력의 유효성을 검사할 때 유용합니다.

참고

ListView.AfterLabelEdit 이벤트는 레이블 편집이 커밋되기 전에 발생하기 때문에 이 이벤트에 대한 처리기에서 ListView.Sort 메서드를 호출하면 항목이 원래 값으로 정렬됩니다.

예제

다음 코드 예제에서는 ListView.BeforeLabelEdit 이벤트를 처리하는 방법과 Item 및 CancelEdit 속성을 사용하는 방법을 보여 줍니다. 이 예제를 실행하려면 이름이 ListView1인 ListView 컨트롤이 들어 있고 세 개 이상의 항목으로 채워진 폼에 다음 코드를 붙여넣습니다. 모든 이벤트가 해당 이벤트 처리 메서드와 연결되도록 합니다.

Private Sub ListView1_BeforeLabelEdit(ByVal sender As Object, _
    ByVal e As System.Windows.Forms.LabelEditEventArgs) _
    Handles ListView1.BeforeLabelEdit

    ' Allow all but the first two items of the list to be modified by
    ' the user.
    If (e.Item < 2) Then
        e.CancelEdit = True
    End If
End Sub

   private void ListView1_BeforeLabelEdit(object sender, 
    System.Windows.Forms.LabelEditEventArgs e)
{
    // Allow all but the first two items of the list to 
    // be modified by the user.
    if (e.Item<2)
    {
        e.CancelEdit = true;
    }
}

void ListView1_BeforeLabelEdit( Object^ sender,
   System::Windows::Forms::LabelEditEventArgs^ e )
{
   // Allow all but the first two items of the list to 
   // be modified by the user.
   if ( e->Item < 2 )
   {
      e->CancelEdit = true;
   }
}

private void listView1_BeforeLabelEdit(Object sender,
    System.Windows.Forms.LabelEditEventArgs e)
{
    // Allow all but the first two items of the list to 
    // be modified by the user.
    if (e.get_Item() < 2) {
        e.set_CancelEdit(true);
    }
} //listView1_BeforeLabelEdit

상속 계층 구조

System.Object
System.EventArgs
System.Windows.Forms.LabelEditEventArgs

스레드로부터의 안전성

이 형식의 모든 public static(Visual Basic의 경우 Shared) 멤버는 스레드로부터 안전합니다. 인터페이스 멤버는 스레드로부터 안전하지 않습니다.

플랫폼

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework에서 모든 플래폼의 모든 버전을 지원하지는 않습니다. 지원되는 버전의 목록은 시스템 요구 사항을 참조하십시오.

버전 정보

.NET Framework

2.0, 1.1, 1.0에서 지원

참고 항목

참조

LabelEditEventArgs 멤버
System.Windows.Forms 네임스페이스
ListView
ListViewItem
ListView.BeforeLabelEdit
ListView.AfterLabelEdit

다음을 통해 공유