ListView.BeforeLabelEdit 事件

当用户开始编辑项的标签时发生。

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

语法

声明
Public Event BeforeLabelEdit As LabelEditEventHandler
用法
Dim instance As ListView
Dim handler As LabelEditEventHandler

AddHandler instance.BeforeLabelEdit, handler

public event LabelEditEventHandler BeforeLabelEdit

public:
event LabelEditEventHandler^ BeforeLabelEdit {
    void add (LabelEditEventHandler^ value);
    void remove (LabelEditEventHandler^ value);
}

/** @event */
public void add_BeforeLabelEdit (LabelEditEventHandler value)

/** @event */
public void remove_BeforeLabelEdit (LabelEditEventHandler value)

JScript 支持使用事件，但不支持进行新的声明。

备注

BeforeLabelEdit 事件在用户开始修改项文本时发生。如果事件处理程序取消该事件，则用户无法编辑该文本。您可以使用该事件防止用户编辑 ListView 控件中的特定项。如果 ListView 控件的 LabelEdit 属性设置为 false，则不会引发 BeforeLabelEdit 事件；所有编辑项标签的用户尝试均会被自动拒绝。

有关处理事件的更多信息，请参见 使用事件。

示例

下面的代码示例演示如何处理 BeforeLabelEdit 事件以及使用 LabelEditEventArgs.Item 和 LabelEditEventArgs.CancelEdit 属性。若要运行该示例，请将以下代码粘贴到一个窗体中，该窗体应包含名为 ListView1 并且至少填充了三项的 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

平台

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

请参见

参考

ListView 类
ListView 成员
System.Windows.Forms 命名空间
OnBeforeLabelEdit
ListView.AfterLabelEdit 事件
LabelEditEventHandler 委托
ListView.LabelEdit 属性