Cette documentation est archivée et n’est pas conservée.

ListViewItem.Position, propriété

Mise à jour : novembre 2007

Obtient ou définit la position de l'angle supérieur gauche de ListViewItem.

Espace de noms :  System.Windows.Forms
Assembly :  System.Windows.Forms (dans System.Windows.Forms.dll)

[BrowsableAttribute(false)]
public Point Position { get; set; }
/** @property */
/** @attribute BrowsableAttribute(false) */
public Point get_Position()
/** @property */
/** @attribute BrowsableAttribute(false) */
public  void set_Position(Point value)

public function get Position () : Point
public function set Position (value : Point)

Valeur de propriété

Type : System.Drawing.Point

Point situé dans l'angle supérieur gauche de ListViewItem.

ExceptionCondition
InvalidOperationException

Position est défini lorsque ListView contenant est en mode virtuel.

La propriété Position doit être définie après la construction de ListViewItem et de ListView contenant. La modification de la propriété Position lorsque ListView contenant est dans Details ou dans l'affichage List n'a aucun effet sur la position des éléments. De plus, la propriété Position changera automatiquement lorsque la propriété View de ListView contenant est modifiée de l'affichage SmallIcon, LargeIcon ou Tile à List ou Details. Lorsque ListView est dans l'affichage SmallIcon, LargeIcon ou Tile, la définition de la propriété Position pour un élément provoquera la réorganisation des autres éléments contenus dans ListView.

L'exemple de code suivant montre comment utiliser la propriété Position de ListViewItem. Pour exécuter cet exemple, collez le code suivant dans un Windows Form et appelez InitializePositionedListViewItems depuis la méthode de gestion d'événements Load du formulaire. Cliquez sur le bouton pour voir les éléments repositionnés.

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 Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professionnel Édition x64, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

.NET Framework

Pris en charge dans : 3.5, 3.0, 2.0
Afficher: