LabelEditEventArgs 类

定义

命名空间:

System.Windows.Forms

程序集:

System.Windows.Forms.dll

提供有关 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)	使用要编辑的 LabelEditEventArgs 的指定索引初始化 ListViewItem 类的新实例。
LabelEditEventArgs(Int32, String)	使用正在被编辑的 LabelEditEventArgs 的指定索引和 ListViewItem 标签的新文本初始化 ListViewItem 类的新实例。

属性

CancelEdit	获取或设置一个值，该值指示是否应取消对 ListViewItem 的标签所作的更改。
Item	获取 ListViewItem（它包含要编辑的标签）的从零开始的索引。
Label	获取分配给 ListViewItem 的标签的新文本。

方法

Equals(Object)	确定指定对象是否等于当前对象。 (继承自 Object)
GetHashCode()	作为默认哈希函数。 (继承自 Object)
GetType()	获取当前实例的 Type。 (继承自 Object)
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
ToString()	返回表示当前对象的字符串。 (继承自 Object)

另请参阅

• ListView
• ListViewItem
• BeforeLabelEdit
• AfterLabelEdit