LabelEditEventArgs 類別

定義

命名空間:

System.Windows.Forms

組件:

System.Windows.Forms.dll

提供 BeforeLabelEdit 和 AfterLabelEdit 事件的資料。

public ref class LabelEditEventArgs : EventArgs

public class LabelEditEventArgs : EventArgs

type LabelEditEventArgs = class
    inherit EventArgs

Public Class LabelEditEventArgs
Inherits EventArgs

繼承

Object

EventArgs

LabelEditEventArgs

範例

下列程式碼範例示範如何處理 ListView.BeforeLabelEdit 事件和使用 Item 和 CancelEdit 屬性。 若要執行此範例，請將下列程式碼貼到包含 ListView 名為 的 ListView1 控制項的表單中，並填入至少 3 個專案。 確定所有事件都與其事件處理方法相關聯。

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

備註

指定 LabelEditEventArgs 的索引和標題 ListViewItem ，以及使用者編輯後標題的索引和標題。 這個類別也提供 CancelEdit 屬性。 您可以在事件處理常式中使用 ListView.BeforeLabelEdit 這個屬性，以防止使用者編輯標籤。 您也可以在事件處理常式中 ListView.AfterLabelEdit 使用它來還原變更，並將標籤傳回至其原始值。 當您想要在認可變更之前驗證使用者輸入時，這會很有用。

注意

由於事件 ListView.AfterLabelEdit 會在認可標籤編輯之前發生， ListView.Sort 因此呼叫這個事件的處理常式中的 方法會使用原始值來排序專案。

建構函式

LabelEditEventArgs(Int32)	對要編輯的 LabelEditEventArgs 使用指定的索引來初始化 ListViewItem 類別的新執行個體。
LabelEditEventArgs(Int32, String)	使用指定要進行編輯的 LabelEditEventArgs 和 ListViewItem 標籤的新文字的索引，來初始化 ListViewItem 類別的新執行個體。

屬性

CancelEdit	取得或設定值，表示對 ListViewItem 的標籤所做的變更是否應該取消。
Item	取得 ListViewItem 的以零起始的索引，包含要編輯的標籤。
Label	取得指派給 ListViewItem 之標籤的新文字。

方法

Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)

另請參閱

• ListView
• ListViewItem
• BeforeLabelEdit
• AfterLabelEdit