Questa documentazione è stata archiviata e non viene gestita.

Proprietà ListViewItem.Position

Nota: questa proprietà è stata introdotta con .NET Framework versione 2.0.

Ottiene o imposta la posizione dell'angolo superiore sinistro dell'oggetto ListViewItem.

Spazio dei nomi: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

public Point Position { get; set; }
/** @property */
public Point get_Position ()

/** @property */
public void set_Position (Point value)

public function get Position () : Point

public function set Position (value : Point)

Valore proprietà

Oggetto Point situato nell'angolo superiore sinistro dell'oggetto ListViewItem.

Tipo di eccezioneCondizione

InvalidOperationException

La proprietà Position viene impostata quando l'oggetto ListView che la contiene è in modalità virtuale.

La proprietà Position deve essere impostata dopo la costruzione dell'oggetto ListViewItem e dell'oggetto ListView contenente. La modifica alla proprietà Position quando l'oggetto ListView che la contiene è nella modalità di visualizzazione Details o List, se apportata, non avrà alcun effetto sulla posizione degli elementi. La proprietà Position, inoltre, viene modificata automaticamente quando la proprietà View dell'oggetto ListView che la contiene viene modificata dalla modalità visualizzazione SmallIcon, LargeIcon o Tile in List o Details. Quando l'oggetto ListView è nella modalità di visualizzazione SmallIcon, LargeIcon o Tile, l'impostazione della proprietà Position per un elemento determina la riorganizzazione degli altri elementi contenuti nell'oggetto ListView.

Nell'esempio di codice riportato di seguito viene illustrato come utilizzare la proprietà Position di un oggetto ListViewItem. Per eseguire l'esempio, inserire il codice riportato di seguito in un form di Windows Form e chiamare il metodo InitializePositionedListViewItems dal metodo di gestione eventi Load del form. Per visualizzare la riorganizzazione degli elementi, fare clic sul pulsante.

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);
}

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile per Pocket PC, Windows Mobile per Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework non supporta tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema.

.NET Framework

Supportato in: 2.0
Mostra: