LabelEditEventArgs Класс

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Исходный код:

LabelEditEventArgs.cs

Предоставляет данные для событий BeforeLabelEdit и AfterLabelEdit.

public ref class LabelEditEventArgs : EventArgs

public class LabelEditEventArgs : EventArgs

type LabelEditEventArgs = class
    inherit EventArgs

Public Class LabelEditEventArgs
Inherits EventArgs

Наследование

Object

EventArgs

LabelEditEventArgs

Примеры

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

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

Комментарии

Указывает LabelEditEventArgs индекс и подпись и ListViewItem подпись после его редактирования пользователем. Этот класс также предоставляет CancelEdit свойство. Это свойство можно использовать в обработчике ListView.BeforeLabelEdit событий, чтобы запретить пользователю изменять метку. Его также можно использовать в обработчике ListView.AfterLabelEdit событий для возврата изменения, возвращая метку в исходное значение. Это полезно, если вы хотите проверить входные данные пользователя перед фиксацией изменения.

Замечание

ListView.AfterLabelEdit Так как событие происходит до фиксации изменения метки, вызов ListView.Sort метода в обработчике для этого события будет сортировать элемент с использованием исходного значения.

Конструкторы

Имя	Описание
LabelEditEventArgs(Int32, String)	Инициализирует новый экземпляр LabelEditEventArgs класса с указанным индексом ListViewItem для редактируемого и нового текста для метки объекта ListViewItem.
LabelEditEventArgs(Int32)	Инициализирует новый экземпляр LabelEditEventArgs класса с указанным индексом для ListViewItem изменения.

Свойства

Имя	Описание
CancelEdit	Возвращает или задает значение, указывающее, должны ли быть отменены изменения, внесенные в метку.ListViewItem
Item	Возвращает отсчитываемый от нуля индекс ListViewItem , содержащий метку для редактирования.
Label	Возвращает новый текст, назначенный меткой объекта ListViewItem.

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

• ListView
• ListViewItem
• BeforeLabelEdit
• AfterLabelEdit