ListView.BeforeLabelEdit ListView.BeforeLabelEdit ListView.BeforeLabelEdit ListView.BeforeLabelEdit Event


ユーザーが項目のラベルの編集を開始すると発生します。Occurs when the user starts editing the label of an item.

 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とプロパティを使用する方法を示しています。The following code example demonstrates handling the BeforeLabelEdit event and using the LabelEditEventArgs.Item and LabelEditEventArgs.CancelEdit properties. この例を実行するには、という名前ListView ListView1のコントロールを含み、少なくとも3つの項目が設定されているフォームに、次のコードを貼り付けます。To run the example, paste the following code into a form that contains a ListView control named ListView1 and populated with at least three items. 例のイベントハンドラーがイベントに関連付けられていることを確認します。Ensure the event handler in the example is associated with its event.

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は、ユーザーがアイテムのテキストの変更を開始したときに発生します。The BeforeLabelEdit event occurs when the user starts modifying the text for an item. イベントハンドラーがこのイベントをキャンセルした場合、ユーザーはテキストを編集できません。If the event handler cancels this event, the user cannot edit the text. このイベントを使用すると、ユーザーがListViewコントロール内の特定の項目を編集できないようにすることができます。You can use this event to prevent the user from editing specific items in the ListView control. コントロールのプロパティがfalseに設定されている場合BeforeLabelEdit 、イベントは発生しません。項目ラベルを編集しようとするユーザーは、すべて自動的に拒否されます。 LabelEdit ListViewIf the LabelEdit property of the ListView control is set to false, the BeforeLabelEdit event is not raised; all user attempts to edit item labels are automatically rejected.

イベントの処理の詳細については、「処理とイベントの発生」を参照してください。For more information about handling events, see Handling and Raising Events.