ListView.BeforeLabelEdit ListView.BeforeLabelEdit ListView.BeforeLabelEdit ListView.BeforeLabelEdit Event

Определение

Происходит при начале изменения метки элемента пользователем.Occurs when the user starts editing the label of an item.

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 .The following code example demonstrates handling the BeforeLabelEdit event and using the LabelEditEventArgs.Item and LabelEditEventArgs.CancelEdit properties. Чтобы выполнить пример, вставьте следующий код в форму, содержащую ListView элемент управления с именем ListView1 и заполненный по крайней мере тремя элементами.To run the example, paste the following code into a form that contains a ListView control named ListView1 and populated with at least three items. Убедитесь, что обработчик событий в примере связан с событием.Ensure the event handler in the example is associated with its event.

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 событие возникает, когда пользователь начинает изменять текст элемента.The BeforeLabelEdit event occurs when the user starts modifying the text for an item. Если обработчик событий отменяет это событие, пользователь не может изменять текст.If the event handler cancels this event, the user cannot edit the text. Это событие можно использовать, чтобы запретить пользователю изменять определенные элементы в ListView элементе управления.You can use this event to prevent the user from editing specific items in the ListView control. LabelEdit Если свойство ListView элемента false управленияBeforeLabelEdit имеет значение, событие не вызывается; все попытки пользователя изменить метки элементов будут автоматически отклонены.If the LabelEdit property of the ListView control is set to false, the BeforeLabelEdit event is not raised; all user attempts to edit item labels are automatically rejected.

Дополнительные сведения об обработке событий см. в разделе обработка и вызов событий.For more information about handling events, see Handling and Raising Events.

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

Дополнительно