ListView.BeforeLabelEdit イベント

定義

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

public:
 event System::Windows::Forms::LabelEditEventHandler ^ BeforeLabelEdit;
public event System.Windows.Forms.LabelEditEventHandler BeforeLabelEdit;
public event System.Windows.Forms.LabelEditEventHandler? BeforeLabelEdit;
member this.BeforeLabelEdit : System.Windows.Forms.LabelEditEventHandler 
Public Custom Event BeforeLabelEdit As LabelEditEventHandler 

イベントの種類

次のコード例では、 イベントを処理し、 BeforeLabelEdit プロパティと LabelEditEventArgs.CancelEdit プロパティを使用する方法をLabelEditEventArgs.Item示します。 この例を実行するには、次のコードをという名前ListView1のコントロールを含みListView、少なくとも 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

注釈

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

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

適用対象

こちらもご覧ください