ListView.BeforeLabelEdit Событие

Определение

Происходит при начале изменения метки элемента пользователем.

public:
 event System::Windows::Forms::LabelEditEventHandler ^ BeforeLabelEdit;
public event System.Windows.Forms.LabelEditEventHandler BeforeLabelEdit;
public event System.Windows.Forms.LabelEditEventHandler? BeforeLabelEdit;
member this.BeforeLabelEdit : System.Windows.Forms.LabelEditEventHandler 
Public Custom Event BeforeLabelEdit As LabelEditEventHandler 

Тип события

Примеры

В следующем примере кода демонстрируется обработка BeforeLabelEdit события и использование LabelEditEventArgs.Item свойств и LabelEditEventArgs.CancelEdit . Чтобы выполнить пример, вставьте следующий код в форму, содержащую ListView элемент управления с именем ListView1 и заполненным по крайней мере тремя элементами. Убедитесь, что обработчик событий в примере связан с его событием.

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.Item<2)
    {
        e.CancelEdit = true;
    }
}

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

Комментарии

Это BeforeLabelEdit событие возникает, когда пользователь начинает изменять текст элемента. Если обработчик событий отменяет это событие, пользователь не сможет изменить текст. Это событие можно использовать, чтобы запретить пользователю изменять определенные элементы в элементе ListView управления . Если свойству LabelEditListView элемента управления присвоено значение false, BeforeLabelEdit событие не вызывается; все попытки изменить метки элементов автоматически отклоняются.

Дополнительные сведения об обработке событий см. в разделе Обработка и вызов событий.

Применяется к

См. также раздел