ListView.BeforeLabelEdit 이벤트

사용자가 항목에 대한 레이블을 편집하기 시작할 때 발생합니다.

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

구문

‘선언
Public Event BeforeLabelEdit As LabelEditEventHandler
‘사용 방법
Dim instance As ListView
Dim handler As LabelEditEventHandler

AddHandler instance.BeforeLabelEdit, handler

public event LabelEditEventHandler BeforeLabelEdit

public:
event LabelEditEventHandler^ BeforeLabelEdit {
    void add (LabelEditEventHandler^ value);
    void remove (LabelEditEventHandler^ value);
}

/** @event */
public void add_BeforeLabelEdit (LabelEditEventHandler value)

/** @event */
public void remove_BeforeLabelEdit (LabelEditEventHandler value)

JScript에서는 이벤트를 사용할 수 있지만 새로 선언할 수는 없습니다.

설명

BeforeLabelEdit 이벤트는 사용자가 항목에 대한 텍스트를 수정하기 시작할 때 발생합니다. 이벤트 처리기가 이 이벤트를 취소하면 사용자는 해당 텍스트를 편집할 수 없습니다. 이 이벤트를 사용하면 사용자가 ListView 컨트롤에 있는 특정 항목을 편집하지 못하도록 만들 수 있습니다. ListView 컨트롤의 LabelEdit 속성이 false로 설정되어 있으면 BeforeLabelEdit 이벤트는 호출되지 않으며 항목 레이블에 대한 모든 사용자의 편집 시도는 자동으로 거부됩니다.

이벤트 처리에 대한 자세한 내용은 이벤트 사용을 참조하십시오.

예제

다음 코드 예제에서는 BeforeLabelEdit 이벤트를 처리하는 방법과 LabelEditEventArgs.Item 및 LabelEditEventArgs.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

플랫폼

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에서 지원

참고 항목

참조

ListView 클래스
ListView 멤버
System.Windows.Forms 네임스페이스
OnBeforeLabelEdit
ListView.AfterLabelEdit 이벤트
LabelEditEventHandler 대리자
ListView.LabelEdit 속성