ListView.BeforeLabelEdit イベント

[アーティクル]
08/14/2007

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

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

構文

'宣言
Public Event BeforeLabelEdit As LabelEditEventHandler
'使用
Dim instance As ListView
Dim handler As LabelEditEventHandler

AddHandler instance.BeforeLabelEdit, handler

public event LabelEditEventHandler BeforeLabelEdit

public:
event LabelEditEventHandler^ BeforeLabelEdit {
    void add (LabelEditEventHandler^ value);
    void remove (LabelEditEventHandler^ value);
}

/** @event */
public void add_BeforeLabelEdit (LabelEditEventHandler value)

/** @event */
public void remove_BeforeLabelEdit (LabelEditEventHandler value)

JScript では、イベントは使用できますが、新規に宣言することはできません。

解説

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

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

使用例

BeforeLabelEdit イベントを処理して、LabelEditEventArgs.Item プロパティと LabelEditEventArgs.CancelEdit プロパティを使用するコード例を次に示します。この例を実行するには、ListView1 という名前の ListView コントロールが配置されているフォームに、次のコードを貼り付けます。このコントロールには少なくとも 3 つの項目が読み込まれています。この例のイベントハンドラを、必ずそのイベントに関連付けるようにしてください。

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

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

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.get_Item() < 2) {
        e.set_CancelEdit(true);
    }
} //listView1_BeforeLabelEdit

プラットフォーム

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

次の方法で共有

ListView.BeforeLabelEdit イベント

構文

解説

使用例

プラットフォーム

バージョン情報

.NET Framework

参照

関連項目

その他のリソース