ListViewItem.Position Property
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Gets or sets the position of the upper-left corner of the ListViewItem.
public:
property System::Drawing::Point Position { System::Drawing::Point get(); void set(System::Drawing::Point value); };
[System.ComponentModel.Browsable(false)]
public System.Drawing.Point Position { get; set; }
[<System.ComponentModel.Browsable(false)>]
member this.Position : System.Drawing.Point with get, set
Public Property Position As Point
The Point at the upper-left corner of the ListViewItem.
- Attributes
The following code example demonstrates how to use the Position property of a ListViewItem. To run this example, paste the following code into a Windows Form and call the InitializePositionedListViewItems
from the form's Load event-handling method. Click the button to see the items repositioned.
private ListView positionListView;
private ListViewItem moveItem;
private Button button1;
private void InitializePositionedListViewItems()
{
// Set some basic properties on the ListView and button.
positionListView = new ListView();
positionListView.Height = 200;
button1 = new Button();
button1.Location = new Point(160, 30);
button1.AutoSize = true;
button1.Text = "Click to reposition";
button1.Click += new System.EventHandler(button1_Click);
// View must be set to icon view to use the Position property.
positionListView.View = View.LargeIcon;
// Create the items and add them to the ListView.
ListViewItem item1 = new ListViewItem("Click");
ListViewItem item2 = new ListViewItem("OK");
moveItem = new ListViewItem("Move");
positionListView.Items.AddRange(new ListViewItem[]
{ item1, item2, moveItem });
// Add the controls to the form.
this.Controls.Add(positionListView);
this.Controls.Add(button1);
}
private void button1_Click(object sender, EventArgs e)
{
moveItem.Position = new Point(30, 30);
}
Private positionListView As ListView
Private moveItem As ListViewItem
Private WithEvents button1 As Button
Private Sub InitializePositionedListViewItems()
' Set some basic properties on the ListView and button.
positionListView = New ListView()
positionListView.Height = 200
button1 = New Button()
button1.Location = New Point(160, 30)
button1.AutoSize = True
button1.Text = "Click to reposition"
' View must be set to icon view to use the Position property.
positionListView.View = View.LargeIcon
' Create the items and add them to the ListView.
Dim item1 As New ListViewItem("Click")
Dim item2 As New ListViewItem("OK")
moveItem = New ListViewItem("Move")
positionListView.Items.AddRange(New ListViewItem() _
{item1, item2, moveItem})
' Add the controls to the form.
Me.Controls.Add(positionListView)
Me.Controls.Add(button1)
End Sub
Private Sub button1_Click(ByVal sender As Object, ByVal e As EventArgs)
moveItem.Position = New Point(30, 30)
End Sub
The Position property should be set after the ListViewItem and containing ListView are constructed. Changing the Position property when the containing ListView is in Details or List view will have no effect on the position of the items. Also, the Position property will automatically change when the View property of the containing ListView is changed from SmallIcon, LargeIcon, or Tile view to List or Details. When the ListView is in SmallIcon, LargeIcon, or Tile view, setting the Position property for an item will cause the other items contained in the ListView to be rearranged.
Product | Versions |
---|---|
.NET Framework | 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
Windows Desktop | 3.0, 3.1, 5, 6, 7, 8, 9 |
.NET feedback
.NET is an open source project. Select a link to provide feedback: