LabelEditEventArgs LabelEditEventArgs LabelEditEventArgs LabelEditEventArgs Class

Определение

Предоставляет данные для событий BeforeLabelEdit и AfterLabelEdit.Provides data for the BeforeLabelEdit and AfterLabelEdit events.

public ref class LabelEditEventArgs : EventArgs
public class LabelEditEventArgs : EventArgs
type LabelEditEventArgs = class
    inherit EventArgs
Public Class LabelEditEventArgs
Inherits EventArgs
Наследование
LabelEditEventArgsLabelEditEventArgsLabelEditEventArgsLabelEditEventArgs

Примеры

В следующем примере кода демонстрируется обработка ListView.BeforeLabelEdit событий и с помощью Item и CancelEdit свойства.The following code example demonstrates handling the ListView.BeforeLabelEdit event and using the Item and CancelEdit properties. Чтобы запустить пример, вставьте следующий код в форму, содержащую ListView управления с именем ListView1 и по меньшей мере три элемента.To run the example, paste the following code in a form containing a ListView control named ListView1 and populated with at least 3 items. Убедитесь, что все события связаны с их методов обработки событий.Ensure all events are associated with their event-handling methods.

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 и заголовок после его изменения пользователем.A LabelEditEventArgs specifies the index and caption of a ListViewItem and the caption after it has been edited by the user. Этот класс также предоставляет CancelEdit свойство.This class also provides a CancelEdit property. Можно использовать это свойство в ListView.BeforeLabelEdit обработчик событий, позволяющее пользователю редактировать метку.You can use this property in a ListView.BeforeLabelEdit event handler to prevent the user from editing the label. Можно также использовать его в ListView.AfterLabelEdit обработчик событий, чтобы отменить изменение, возвращая метки его исходное значение.You can also use it in an ListView.AfterLabelEdit event handler to revert the change, returning the label it to its original value. Это полезно при проверке вводимых пользователем данных перед фиксацией изменения.This is useful when you want to validate user input before committing the change.

Примечание

Так как ListView.AfterLabelEdit событий производится до выполнения редактирование метки зафиксирован, вызов ListView.Sort метод в обработчике этого события выполняет сортировку элементов, используя исходное значение.Because the ListView.AfterLabelEdit event takes place before the label edit is committed, calling the ListView.Sort method in a handler for this event will sort the item using the original value.

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

LabelEditEventArgs(Int32) LabelEditEventArgs(Int32) LabelEditEventArgs(Int32) LabelEditEventArgs(Int32)

Инициализирует новый экземпляр класса LabelEditEventArgs с указанным индексом изменяемого параметра ListViewItem.Initializes a new instance of the LabelEditEventArgs class with the specified index to the ListViewItem to edit.

LabelEditEventArgs(Int32, String) LabelEditEventArgs(Int32, String) LabelEditEventArgs(Int32, String) LabelEditEventArgs(Int32, String)

Инициализирует новый экземпляр класса LabelEditEventArgs указанным индексом изменяемого параметра ListViewItem и новым текстом метки параметра ListViewItem.Initializes a new instance of the LabelEditEventArgs class with the specified index to the ListViewItem being edited and the new text for the label of the ListViewItem.

Свойства

CancelEdit CancelEdit CancelEdit CancelEdit

Получает или задает значение, указывающее, должны ли быть отменены изменения, выполненные с меткой параметра ListViewItem.Gets or sets a value indicating whether changes made to the label of the ListViewItem should be canceled.

Item Item Item Item

Получает начинающийся с нуля индекс параметра ListViewItem, содержащего изменяемую метку.Gets the zero-based index of the ListViewItem containing the label to edit.

Label Label Label Label

Получает новый текст, присвоенный метке параметра ListViewItem.Gets the new text assigned to the label of the ListViewItem.

Методы

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Определяет, равен ли заданный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Inherited from Object)

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

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