LabelEditEventArgs クラスとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

LabelEditEventArgs クラス

ListView.BeforeLabelEdit イベントと ListView.AfterLabelEdit イベントのデータを提供します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public Class LabelEditEventArgs
    Inherits EventArgs

Visual Basic (使用法)

Dim instance As LabelEditEventArgs

public class LabelEditEventArgs : EventArgs

C++

public ref class LabelEditEventArgs : public
 EventArgs

public class LabelEditEventArgs extends EventArgs

JScript

public class LabelEditEventArgs extends
 EventArgs

解説

LabelEditEventArgs は、ListViewItem のインデックスとキャプション、およびユーザーが編集した後のキャプションを指定します。このクラスは CancelEdit プロパティも提供します。ListView.BeforeLabelEdit イベントハンドラでこのプロパティを使用して、ユーザーがラベルを編集できないようにすることができます。また、ListView.AfterLabelEdit イベントハンドラでこのプロパティを使用して変更を取り消し、ラベルを元の値に戻すこともできます。これは、変更をコミットする前にユーザー入力を検証する場合に役立ちます。

メモ
ラベルの編集がコミットされる前に ListView.AfterLabelEdit イベントが実行されるため、このイベントのハンドラで ListView.Sort メソッドを呼び出すと、元の値を使用して項目を並べ替えます。

使用例

ListView.BeforeLabelEdit イベントを処理して、Item プロパティと CancelEdit プロパティを使用するコード例を次に示します。この例を実行するには、ListView1 という名前の ListView コントロールが配置されているフォームに、次のコードを貼り付けます。このコントロールには少なくとも 3 つの項目が読み込まれています。必ずすべてのイベントをイベント処理メソッドに関連付けるようにしてください。

Visual Basic

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;
    }
}

C++

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