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 событие не вызывается; все попытки изменить метки элементов автоматически отклоняются.
Дополнительные сведения об обработке событий см. в разделе Обработка и вызов событий.