ListView.LabelEdit 属性

定义

命名空间:

System.Windows.Forms

程序集:

System.Windows.Forms.dll

Source:

ListView.cs

获取或设置一个值，该值指示用户是否可以编辑控件中项的标签。

C#

public bool LabelEdit { get; set; }

属性值

Boolean

如果用户可以在运行时编辑项的标签，则为 true；否则，为 false。 默认值为 false。

示例

下面的代码示例创建一个控件，其中包含为每个项指定了三ListViewItem个ListView对象和三个ListViewItem.ListViewSubItem对象。 该示例还创建 ColumnHeader 对象以在详细信息视图中显示子项。 在代码示例中还创建了两个 ImageList 对象，为对象提供图像 ListViewItem 。 这些 ImageList 对象将添加到 LargeImageList 和 SmallImageList 属性。 该示例在创建 ListView 控件时使用以下属性。

• View

• LabelEdit

• AllowColumnReorder

• CheckBoxes

• FullRowSelect

• GridLines

• Sorting

此示例要求已将代码添加到 ， Form 并从构造函数或窗体上的另一个方法调用在示例中创建的方法。 该示例还要求名为 MySmallImage1、 MySmallImage2、 MyLargeImage1和 MyLargeImage2 的映像位于驱动器 C 的根目录中。

C#

private void CreateMyListView()
{
    // Create a new ListView control.
    ListView listView1 = new ListView();
    listView1.Bounds = new Rectangle(new Point(10,10), new Size(300,200));

    // Set the view to show details.
    listView1.View = View.Details;
    // Allow the user to edit item text.
    listView1.LabelEdit = true;
    // Allow the user to rearrange columns.
    listView1.AllowColumnReorder = true;
    // Display check boxes.
    listView1.CheckBoxes = true;
    // Select the item and subitems when selection is made.
    listView1.FullRowSelect = true;
    // Display grid lines.
    listView1.GridLines = true;
    // Sort the items in the list in ascending order.
    listView1.Sorting = SortOrder.Ascending;
                
    // Create three items and three sets of subitems for each item.
    ListViewItem item1 = new ListViewItem("item1",0);
    // Place a check mark next to the item.
    item1.Checked = true;
    item1.SubItems.Add("1");
    item1.SubItems.Add("2");
    item1.SubItems.Add("3");
    ListViewItem item2 = new ListViewItem("item2",1);
    item2.SubItems.Add("4");
    item2.SubItems.Add("5");
    item2.SubItems.Add("6");
    ListViewItem item3 = new ListViewItem("item3",0);
    // Place a check mark next to the item.
    item3.Checked = true;
    item3.SubItems.Add("7");
    item3.SubItems.Add("8");
    item3.SubItems.Add("9");

    // Create columns for the items and subitems.
    // Width of -2 indicates auto-size.
    listView1.Columns.Add("Item Column", -2, HorizontalAlignment.Left);
    listView1.Columns.Add("Column 2", -2, HorizontalAlignment.Left);
    listView1.Columns.Add("Column 3", -2, HorizontalAlignment.Left);
    listView1.Columns.Add("Column 4", -2, HorizontalAlignment.Center);

    //Add the items to the ListView.
    listView1.Items.AddRange(new ListViewItem[]{item1,item2,item3});

    // Create two ImageList objects.
    ImageList imageListSmall = new ImageList();
    ImageList imageListLarge = new ImageList();

    // Initialize the ImageList objects with bitmaps.
    imageListSmall.Images.Add(Bitmap.FromFile("C:\\MySmallImage1.bmp"));
    imageListSmall.Images.Add(Bitmap.FromFile("C:\\MySmallImage2.bmp"));
    imageListLarge.Images.Add(Bitmap.FromFile("C:\\MyLargeImage1.bmp"));
    imageListLarge.Images.Add(Bitmap.FromFile("C:\\MyLargeImage2.bmp"));

    //Assign the ImageList objects to the ListView.
    listView1.LargeImageList = imageListLarge;
    listView1.SmallImageList = imageListSmall;

    // Add the ListView to the control collection.
    this.Controls.Add(listView1);
}

注解

当 属性 LabelEdit 设置为 true时，用户可以通过单击项文本将其选中，然后再次单击项文本以将标签文本置于编辑模式来修改项的文本。 然后，用户可以修改或替换项的文本标签。 可以使用 BeforeLabelEdit 和 AfterLabelEdit 事件在用户编辑项文本之前和之后执行任务。 如果此属性设置为 true，则无法修改子项的文本。 若要更改子项的文本，可以在用户双击控件中的子项时显示一个对话框。

备注

如果属性 Activation 设置为 OneClick 或 TwoClick，则无论属性的值 LabelEdit 如何，都不允许标签编辑。

适用于

另请参阅

• BeforeLabelEdit
• AfterLabelEdit