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 |
