ListView.BeforeLabelEdit イベント


ユーザーが項目のラベルの編集を開始すると発生します。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.Item プロパティと LabelEditEventArgs.CancelEdit プロパティを使用する方法を示します。The following code example demonstrates handling the BeforeLabelEdit event and using the LabelEditEventArgs.Item and LabelEditEventArgs.CancelEdit properties. この例を実行するには、次のコードを ListView1 という名前の @no__t 0 コントロールを含むフォームに貼り付け、少なくとも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


@No__t-0 イベントは、ユーザーがアイテムのテキストの変更を開始したときに発生します。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. このイベントを使用すると、ユーザーが @no__t 0 コントロールの特定の項目を編集できないようにすることができます。You can use this event to prevent the user from editing specific items in the ListView control. @No__t-1 コントロールの @no__t 0 プロパティが false に設定されている場合、BeforeLabelEdit イベントは発生しません。ユーザーが項目ラベルを編集しようとしても、すべて自動的に拒否されます。If 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.