ListView.BeforeLabelEdit 事件

定义

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

public:
 event System::Windows::Forms::LabelEditEventHandler ^ BeforeLabelEdit;
public event System.Windows.Forms.LabelEditEventHandler BeforeLabelEdit;
public event System.Windows.Forms.LabelEditEventHandler? BeforeLabelEdit;
member this.BeforeLabelEdit : System.Windows.Forms.LabelEditEventHandler 
Public Custom Event BeforeLabelEdit As LabelEditEventHandler 

事件类型

示例

下面的代码示例演示如何处理 BeforeLabelEdit 事件并使用 LabelEditEventArgs.ItemLabelEditEventArgs.CancelEdit 属性。 若要运行该示例,请将以下代码粘贴到包含 ListView 名为 ListView1 的控件的窗体中,并填充了至少三个项。 确保示例中的事件处理程序与其事件相关联。

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

注解

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

有关处理事件的详细信息,请参阅 处理和引发事件

适用于

另请参阅