ListView.BeforeLabelEdit 事件
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
当用户开始编辑项的标签时发生。
public:
event System::Windows::Forms::LabelEditEventHandler ^ BeforeLabelEdit;C#
public event System.Windows.Forms.LabelEditEventHandler BeforeLabelEdit;C#
public event System.Windows.Forms.LabelEditEventHandler? BeforeLabelEdit;member this.BeforeLabelEdit : System.Windows.Forms.LabelEditEventHandler Public Custom Event BeforeLabelEdit As LabelEditEventHandler 下面的代码示例演示如何处理 BeforeLabelEdit 事件并使用 LabelEditEventArgs.Item 和 LabelEditEventArgs.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;
}
}
C#
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;所有尝试编辑项目标签的用户都将自动被拒绝。
有关处理事件的详细信息，请参阅 处理和引发事件。
| 产品 | 版本 |
|---|---|
| .NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| Windows Desktop | 3.0, 3.1, 5, 6, 7, 8, 9, 10 |
