LabelEditEventArgs LabelEditEventArgs LabelEditEventArgs LabelEditEventArgs Class

定義

BeforeLabelEdit イベントおよび AfterLabelEdit イベントのデータを提供します。Provides data for the BeforeLabelEdit and AfterLabelEdit events.

public ref class LabelEditEventArgs : EventArgs
public class LabelEditEventArgs : EventArgs
type LabelEditEventArgs = class
    inherit EventArgs
Public Class LabelEditEventArgs
Inherits EventArgs
継承
LabelEditEventArgsLabelEditEventArgsLabelEditEventArgsLabelEditEventArgs

次のコード例は、 ListView.BeforeLabelEditイベントを処理し、プロパティCancelEdit Itemとプロパティを使用する方法を示しています。The following code example demonstrates handling the ListView.BeforeLabelEdit event and using the Item and CancelEdit properties. この例を実行するには、という名前ListView ListView1のコントロールを含むフォームに次のコードを貼り付け、3つ以上の項目を設定します。To run the example, paste the following code in a form containing a ListView control named ListView1 and populated with at least 3 items. すべてのイベントがイベント処理メソッドに関連付けられていることを確認します。Ensure all events are associated with their event-handling methods.

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

注釈

LabelEditEventArgs 、ユーザーによって編集さListViewItemれた後に、のインデックスとキャプション、およびキャプションを指定します。A LabelEditEventArgs specifies the index and caption of a ListViewItem and the caption after it has been edited by the user. このクラスは、 CancelEditプロパティも提供します。This class also provides a CancelEdit property. このプロパティをListView.BeforeLabelEditイベントハンドラーで使用すると、ユーザーがラベルを編集できないようにすることができます。You can use this property in a ListView.BeforeLabelEdit event handler to prevent the user from editing the label. また、 ListView.AfterLabelEditイベントハンドラーでそれを使用して変更を元の値に戻すこともできます。You can also use it in an ListView.AfterLabelEdit event handler to revert the change, returning the label it to its original value. これは、変更をコミットする前にユーザー入力を検証する場合に便利です。This is useful when you want to validate user input before committing the change.

注意

イベントはListView.AfterLabelEditラベルの編集がコミットされる前に発生するためListView.Sort 、このイベントのハンドラーでメソッドを呼び出すと、元の値を使用して項目が並べ替えられます。Because the ListView.AfterLabelEdit event takes place before the label edit is committed, calling the ListView.Sort method in a handler for this event will sort the item using the original value.

コンストラクター

LabelEditEventArgs(Int32) LabelEditEventArgs(Int32) LabelEditEventArgs(Int32) LabelEditEventArgs(Int32)

編集対象の LabelEditEventArgs への指定したインデックスを使用して、ListViewItem クラスの新しいインスタンスを初期化します。Initializes a new instance of the LabelEditEventArgs class with the specified index to the ListViewItem to edit.

LabelEditEventArgs(Int32, String) LabelEditEventArgs(Int32, String) LabelEditEventArgs(Int32, String) LabelEditEventArgs(Int32, String)

編集中の LabelEditEventArgs の指定したインデックスと、ListViewItem のラベルに表示する新しいテキストを使用して、ListViewItem クラスの新しいインスタンスを初期化します。Initializes a new instance of the LabelEditEventArgs class with the specified index to the ListViewItem being edited and the new text for the label of the ListViewItem.

プロパティ

CancelEdit CancelEdit CancelEdit CancelEdit

ListViewItem のラベルの変更をキャンセルするかどうかを示す値を取得または設定します。Gets or sets a value indicating whether changes made to the label of the ListViewItem should be canceled.

Item Item Item Item

編集対象のラベルを保持している ListViewItem の 0 から始まるインデックス番号を取得します。Gets the zero-based index of the ListViewItem containing the label to edit.

Label Label Label Label

ListViewItem のラベルに割り当てられた新しいテキストを取得します。Gets the new text assigned to the label of the ListViewItem.

メソッド

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

指定したオブジェクトが、現在のオブジェクトと等しいかどうかを判断します。Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

既定のハッシュ関数として機能します。Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

現在のオブジェクトを表す文字列を返します。Returns a string that represents the current object.

(Inherited from Object)

適用対象

こちらもご覧ください