LabelEditEventArgs

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

LabelEditEventArgs クラス

ListView.BeforeLabelEdit イベントと ListView.AfterLabelEdit イベントのデータを提供します。

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

Visual Basic (宣言)

Public Class LabelEditEventArgs
    Inherits EventArgs

Visual Basic (使用法)

Dim instance As LabelEditEventArgs

C#

public class LabelEditEventArgs : EventArgs

C++

public ref class LabelEditEventArgs : public
 EventArgs

J#

public class LabelEditEventArgs extends EventArgs

JScript

public class LabelEditEventArgs extends
 EventArgs

解説

LabelEditEventArgs は、ListViewItem のインデックスとキャプション、およびユーザーが編集した後のキャプションを指定します。このクラスは CancelEdit プロパティも提供します。ListView.BeforeLabelEdit イベント ハンドラでこのプロパティを使用して、ユーザーがラベルを編集できないようにすることができます。また、ListView.AfterLabelEdit イベント ハンドラでこのプロパティを使用して変更を取り消し、ラベルを元の値に戻すこともできます。これは、変更をコミットする前にユーザー入力を検証する場合に役立ちます。

メモ
ラベルの編集がコミットされる前に ListView.AfterLabelEdit イベントが実行されるため、このイベントのハンドラで ListView.Sort メソッドを呼び出すと、元の値を使用して項目を並べ替えます。

使用例

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

C#

   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;
   }
}

J#

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

継承階層

System.Object
   System.EventArgs
    System.Windows.Forms.LabelEditEventArgs

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
LabelEditEventArgs メンバ
System.Windows.Forms 名前空間
ListView
ListViewItem
ListView.BeforeLabelEdit
ListView.AfterLabelEdit

LabelEditEventArgs コンストラクタ (Int32, String)

編集中の ListViewItem の指定したインデックスと、ListViewItem のラベルに表示する新しいテキストを使用して、LabelEditEventArgs クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    item As Integer, _
    label As String _
)

Visual Basic (使用法)

Dim item As Integer
Dim label As String

Dim instance As New LabelEditEventArgs(item,
 label)

C#

public LabelEditEventArgs (
    int item,
    string label
)

C++

public:
LabelEditEventArgs (
    int item, 
    String^ label
)

J#

public LabelEditEventArgs (
    int item, 
    String label
)

JScript

public function LabelEditEventArgs (
    item : int, 
    label : String
)

パラメータ

item

編集するラベルを保持している ListViewItem の 0 から始まるインデックス番号。

label

ListViewItem のラベルに割り当てられた新しいテキスト。

解説

実行時に ListView.BeforeLabelEdit イベントまたは ListView.AfterLabelEdit イベントを発生させる場合は、このコンストラクタを使用して、編集対象の ListView 内のリスト項目を指定できます。このコンストラクタを使用すると、ListViewItem のラベルに関連付けた新しいテキストも指定できます。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
LabelEditEventArgs クラス
LabelEditEventArgs メンバ
System.Windows.Forms 名前空間

LabelEditEventArgs コンストラクタ (Int32)

編集対象の ListViewItem への指定したインデックスを使用して、LabelEditEventArgs クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    item As Integer _
)

Visual Basic (使用法)

Dim item As Integer

Dim instance As New LabelEditEventArgs(item)

C#

public LabelEditEventArgs (
    int item
)

C++

public:
LabelEditEventArgs (
    int item
)

J#

public LabelEditEventArgs (
    int item
)

JScript

public function LabelEditEventArgs (
    item : int
)

パラメータ

item

編集するラベルを保持している ListViewItem の 0 から始まるインデックス番号。

解説

実行時に ListView.BeforeLabelEdit イベントまたは ListView.AfterLabelEdit イベントを発生させる場合は、このコンストラクタを使用して、編集対象の ListView 内にある特定のリスト項目を指定できます。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
LabelEditEventArgs クラス
LabelEditEventArgs メンバ
System.Windows.Forms 名前空間

LabelEditEventArgs コンストラクタ

LabelEditEventArgs クラスの新しいインスタンスを初期化します。
オーバーロードの一覧

名前	説明
LabelEditEventArgs (Int32)	編集対象の ListViewItem への指定したインデックスを使用して、LabelEditEventArgs クラスの新しいインスタンスを初期化します。
LabelEditEventArgs (Int32, String)	編集中の ListViewItem の指定したインデックスと、ListViewItem のラベルに表示する新しいテキストを使用して、LabelEditEventArgs クラスの新しいインスタンスを初期化します。

参照

関連項目

LabelEditEventArgs クラス
LabelEditEventArgs メンバ
System.Windows.Forms 名前空間

LabelEditEventArgs プロパティ

パブリック プロパティ

	名前	説明
	CancelEdit	ListViewItem のラベルの変更をキャンセルするかどうかを示す値を取得または設定します。
	Item	編集対象のラベルを保持している ListViewItem の 0 から始まるインデックス番号を取得します。
	Label	ListViewItem のラベルに割り当てられた新しいテキストを取得します。

参照

関連項目

LabelEditEventArgs クラス
System.Windows.Forms 名前空間
ListView
ListViewItem
ListView.BeforeLabelEdit
ListView.AfterLabelEdit

LabelEditEventArgs メソッド

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)

参照

関連項目

LabelEditEventArgs クラス
System.Windows.Forms 名前空間
ListView
ListViewItem
ListView.BeforeLabelEdit
ListView.AfterLabelEdit

LabelEditEventArgs メンバ

ListView.BeforeLabelEdit イベントと ListView.AfterLabelEdit イベントのデータを提供します。

LabelEditEventArgs データ型で公開されるメンバを以下の表に示します。

パブリック コンストラクタ

	名前	説明
	LabelEditEventArgs	オーバーロードされます。 LabelEditEventArgs クラスの新しいインスタンスを初期化します。

パブリック プロパティ

	名前	説明
	CancelEdit	ListViewItem のラベルの変更をキャンセルするかどうかを示す値を取得または設定します。
	Item	編集対象のラベルを保持している ListViewItem の 0 から始まるインデックス番号を取得します。
	Label	ListViewItem のラベルに割り当てられた新しいテキストを取得します。

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)

参照

関連項目

LabelEditEventArgs クラス
System.Windows.Forms 名前空間
ListView
ListViewItem
ListView.BeforeLabelEdit
ListView.AfterLabelEdit