ListViewItem.Position 속성

정의

ListViewItem의 왼쪽 맨 위 위치를 가져오거나 설정합니다.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; }
member this.Position : System.Drawing.Point with get, set
Public Property Position As Point

속성 값

Point의 왼쪽 맨 위에 있는 ListViewItem입니다.The Point at the upper-left corner of the ListViewItem.

특성

예외

포함하는 Position가 가상 모드에 있을 때 ListView이 설정된 경우The Position is set when the containing ListView is in virtual mode.

예제

다음 코드 예제에서는 ListViewItemPosition 속성을 사용 하는 방법을 보여 줍니다.The following code example demonstrates how to use the Position property of a ListViewItem. 이 예제를 실행 하려면 다음 코드를 Windows Form에 붙여넣고 폼의 Load 이벤트 처리 메서드에서 InitializePositionedListViewItems를 호출 합니다.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

설명

ListViewItem를 포함 하 고 ListView를 포함 하는 Position 속성을 설정 해야 합니다.The Position property should be set after the ListViewItem and containing ListView are constructed. 포함 하는 ListView Details 또는 List 뷰에 있을 때 Position 속성을 변경 해도 항목의 위치에는 영향을 주지 않습니다.Changing the Position property when the containing ListView is in Details or List view will have no effect on the position of the items. 또한 포함 하는 ListViewView 속성이 SmallIcon, LargeIcon또는 Tile 뷰에서 List 또는 Details로 변경 되 면 Position 속성이 자동으로 변경 됩니다.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. ListView SmallIcon, LargeIcon또는 Tile 뷰에 있으면 항목에 대 한 Position 속성을 설정 하면 ListView에 포함 된 다른 항목이 다시 정렬 됩니다.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.

적용 대상

추가 정보