ListViewItem.Position Eigenschaft

Referenz

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft die Position der linken oberen Ecke von ListViewItem ab oder legt diese fest.

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

Eigenschaftswert

Point

Der Point in der linken oberen Ecke von ListViewItem.

Attribute: BrowsableAttribute

Ausnahmen

InvalidOperationException

Die Position wird festgelegt, wenn sich die enthaltende ListView im virtuellen Modus befindet.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die Position -Eigenschaft eines ListViewItemverwendet wird. Fügen Sie zum Ausführen dieses Beispiels den folgenden Code in ein Windows Form-Formular ein, und rufen Sie aus InitializePositionedListViewItems der Ereignisbehandlungsmethode des Formulars Load auf. Klicken Sie auf die Schaltfläche, um die neu positionierten Elemente anzuzeigen.

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

Hinweise

Die Position -Eigenschaft sollte festgelegt werden, nachdem und ListViewItem enthaltend ListView erstellt wurden. Das Ändern der Position Eigenschaft, wenn sich das enthaltende ListView in oder List der Details Ansicht befindet, hat keine Auswirkungen auf die Position der Elemente. Außerdem ändert sich die Position -Eigenschaft automatisch, wenn die View -Eigenschaft des enthaltenden ListView von SmallIcon, LargeIconoder Tile der Ansicht in List oder Detailsgeändert wird. Wenn sich in der ListView SmallIcon- oder Tile LargeIcon-Ansicht befindet, führt das Festlegen der Position -Eigenschaft für ein Element dazu, dass die anderen im ListView enthaltenen Elemente neu angeordnet werden.

Gilt für: