LabelEditEventArgs 类

提供有关 ListView.BeforeLabelEdit 和 ListView.AfterLabelEdit 事件的数据。

**命名空间:**System.Windows.Forms
**程序集:**System.Windows.Forms（在 system.windows.forms.dll 中）

语法

声明
Public Class LabelEditEventArgs
    Inherits EventArgs
用法
Dim instance As LabelEditEventArgs

public class LabelEditEventArgs : EventArgs

public ref class LabelEditEventArgs : public EventArgs

public class LabelEditEventArgs extends EventArgs

public class LabelEditEventArgs extends EventArgs

备注

LabelEditEventArgs 指定 ListViewItem 的索引和标题以及用户对其进行编辑之后的标题。此类还提供一个 CancelEdit 属性。您可以在 ListView.BeforeLabelEdit 事件处理程序中使用此属性，以阻止用户编辑该标签。您也可以在 ListView.AfterLabelEdit 事件处理程序中使用此属性来恢复更改，使标签的值返回为其原始值。当您希望在提交更改前验证用户输入时，这十分有用。

提示

因为 ListView.AfterLabelEdit 事件发生在提交标签编辑前，所以在此事件的处理程序中调用 ListView.Sort 方法时将根据原始值对项进行排序。

示例

下面的代码示例演示如何处理 ListView.BeforeLabelEdit 事件以及使用 Item 和 CancelEdit 属性。若要运行该示例，请将以下代码粘贴到一个窗体中，而该窗体包含名为 ListView1 并且至少填充了 3 项的 ListView 控件。确保所有事件均与其事件处理方法相关联。

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

   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;
    }
}

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.get_Item() < 2) {
        e.set_CancelEdit(true);
    }
} //listView1_BeforeLabelEdit

继承层次结构

System.Object
   System.EventArgs
    System.Windows.Forms.LabelEditEventArgs

线程安全

此类型的任何公共静态（Visual Basic 中的 Shared）成员都是线程安全的，但不保证所有实例成员都是线程安全的。

平台

Windows 98、Windows 2000 SP4、Windows CE、Windows Millennium Edition、Windows Mobile for Pocket PC、Windows Mobile for Smartphone、Windows Server 2003、Windows XP Media Center Edition、Windows XP Professional x64 Edition、Windows XP SP2、Windows XP Starter Edition

.NET Framework 并不是对每个平台的所有版本都提供支持。有关受支持版本的列表，请参见系统要求。

版本信息

.NET Framework

受以下版本支持：2.0、1.1、1.0

请参见

参考

LabelEditEventArgs 成员
System.Windows.Forms 命名空间
ListView
ListViewItem
ListView.BeforeLabelEdit
ListView.AfterLabelEdit