ListView.BeforeLabelEdit イベントとは何？わかりやすく解説 Weblio辞書

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

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

ListView.BeforeLabelEdit イベント

ユーザーが項目のラベルの編集を開始すると発生します。

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

Visual Basic (宣言)

Public Event BeforeLabelEdit As
 LabelEditEventHandler

Visual Basic (使用法)

Dim instance As ListView
Dim handler As LabelEditEventHandler

AddHandler instance.BeforeLabelEdit, handler

public event LabelEditEventHandler BeforeLabelEdit

C++

public:
event LabelEditEventHandler^ BeforeLabelEdit {
    void add (LabelEditEventHandler^ value);
    void remove (LabelEditEventHandler^ value);
}

/** @event */
public void add_BeforeLabelEdit (LabelEditEventHandler
 value)

/** @event */
public void remove_BeforeLabelEdit (LabelEditEventHandler
 value)

JScript

JScript では、イベントは使用できますが、新規に宣言することはできません。

解説

BeforeLabelEdit イベントは、ユーザーが項目のテキストの変更を開始すると発生します。イベントハンドラがこのイベントをキャンセルすると、ユーザーはテキストを編集できません。このイベントを使用して、ListView コントロール内の特定の項目をユーザーが編集できないように設定できます。ListView コントロールの LabelEdit プロパティが false に設定されている場合、BeforeLabelEdit イベントは発生せず、ユーザーが項目のラベルを編集しようとしても、すべて自動的に拒否されます。

イベント処理の詳細については、「イベントの利用」を参照してください。

使用例

BeforeLabelEdit イベントを処理して、LabelEditEventArgs.Item プロパティと LabelEditEventArgs.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