LabelEditEventArgs.CancelEdit プロパティ

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

LabelEditEventArgs.CancelEdit プロパティ

ListViewItem のラベルの変更をキャンセルするかどうかを示す値を取得または設定します。

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

Visual Basic (宣言)

Public Property CancelEdit As
 Boolean

Visual Basic (使用法)

Dim instance As LabelEditEventArgs
Dim value As Boolean

value = instance.CancelEdit

instance.CancelEdit = value

C#

public bool CancelEdit { get;
 set; }

C++

public:
property bool CancelEdit {
    bool get ();
    void set (bool value);
}

J#

/** @property */
public boolean get_CancelEdit ()

/** @property */
public void set_CancelEdit (boolean value)

JScript

public function get CancelEdit
 () : boolean

public function set CancelEdit
 (value : boolean)

プロパティ値
ListViewItem のラベルの編集をキャンセルする場合は true。それ以外の場合は false。

解説

このプロパティを使用すると、ListViewItem のラベルの変更をキャンセルし、元のテキストに戻すことができます。項目のキャプションが、アプリケーションの要件を満たさない値に変更されることを防ぐ場合は、このプロパティを使用します。

使用例

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

プラットフォーム

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 名前空間