ListViewItem.Position Свойство

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Получает или задает позицию верхнего левого угла объекта 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

Значение свойства

Point

Объект Point, расположенный в левом верхнем углу объекта ListViewItem.

Атрибуты

BrowsableAttribute

Исключения

InvalidOperationException

Свойство Position устанавливается, когда содержащий его объект ListView находится в виртуальном режиме.

Примеры

В следующем примере кода показано, как использовать Position свойство объекта ListViewItem. Чтобы запустить этот пример, вставьте следующий код в Форму Windows Forms и вызовите InitializePositionedListViewItems из метода обработки событий формы Load . Нажмите кнопку, чтобы просмотреть элементы, которые были перемещены.

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

Комментарии

Свойство Position должно быть задано ListViewItem после создания и , содержащего ListView . Изменение свойства, Position когда содержится ListView в Details или List представлении, не повлияет на положение элементов. Кроме того, свойство автоматически изменится при PositionView изменении свойства содержащего ListView объекта с SmallIcon, LargeIconили Tile представления на List или Details. ListView Если объект находится в SmallIconпредставлении , LargeIconили Tile , установка Position свойства для элемента приведет к тому, что другие элементы, содержащиеся в ListView , будут переупорядочены.

См. также раздел

• ListView
• View
• Point