ShapeCollection, classe

Article
05/16/2015

Représente une collection d'objets Shape.

Hiérarchie d'héritage

Object
Microsoft.VisualBasic.PowerPacks.ShapeCollection

Espace de noms : Microsoft.VisualBasic.PowerPacks
Assembly : Microsoft.VisualBasic.PowerPacks.Vs (dans Microsoft.VisualBasic.PowerPacks.Vs.dll)

Syntaxe

'Déclaration
Public NotInheritable Class ShapeCollection _
    Implements IList, IDisposable

public sealed class ShapeCollection : IList, 
    IDisposable

public ref class ShapeCollection sealed : IList, 
    IDisposable

[<Sealed>]
type ShapeCollection =  
    class 
        interface IList 
        interface IDisposable 
    end

public final class ShapeCollection implements IList, IDisposable

Le type ShapeCollection expose les membres suivants.

Constructeurs

	Nom	Description
	ShapeCollection	Initialise une nouvelle instance de la classe ShapeCollection.

Début

Propriétés

	Nom	Description
	Count	Obtient le nombre de formes contenues dans la collection.
	IsReadOnly	Obtient une valeur indiquant si une collection est en lecture seule.
	Item	Obtient le Shape à la position d'index spécifiée dans la collection.
	Owner	Obtient le ShapeContainer qui détient la ShapeCollection.

Début

Méthodes

	Nom	Description
	Add	Ajoute le Shape spécifié à ShapeCollection.
	AddRange	Ajoute un tableau d'objets Shape au ShapeCollection.
	Clear	Supprime toutes les formes de la collection.
	Contains	Détermine si la Shape spécifiée est un membre de la collection.
	ContainsKey	Détermine si ShapeCollection contient un élément avec la clé spécifiée.
	CopyTo	Copie la ShapeCollection entière dans un Array unidimensionnel compatible, en commençant à l'index spécifié du tableau de destination.
	Dispose	Libère les ressources non managées utilisées par ShapeCollection.
	Equals	Détermine si l'objet spécifié est identique à l'objet actuel. (Hérité de Object.)
	GetChildIndex(Shape)	Récupère l'index de l'objet Shape dans la ShapeCollection.
	GetChildIndex(Shape, Boolean)	Récupère l'index de la Shape spécifiée dans la ShapeCollection et lève éventuellement une exception si la Shape spécifiée n'est pas dans la ShapeCollection.
	GetEnumerator	Récupère une référence à un objet énumérateur utilisé pour parcourir une ShapeCollection.
	GetHashCode	Sert de fonction de hachage par défaut. (Hérité de Object.)
	GetType	Obtient le Type de l'instance actuelle. (Hérité de Object.)
	IndexOf	Récupère l'index de l'objet Shape dans la ShapeCollection.
	IndexOfKey	Récupère l'index de la première occurrence de l'élément spécifié dans la collection.
	Remove	Supprime le Shape spécifié de la ShapeCollection.
	RemoveAt	Supprime une Shape à partir de la ShapeCollection au niveau de l'index spécifié.
	SetChildIndex	Définit l'index de la Shape spécifiée dans la ShapeCollection à la valeur d'index spécifiée.
	ToString	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object.)

Début

Implémentations d'interface explicite

	Nom	Description
	IList.Add
	IList.Contains
	ICollection.CopyTo
	IList.IndexOf
	IList.Insert
	IList.IsFixedSize
	ICollection.IsSynchronized
	IList.Remove
	ICollection.SyncRoot

Début

Notes

Add, Remove, et les méthodes de RemoveAt vous permettent d'ajouter et de supprimer des formes individuels de la collection. Vous pouvez également utiliser la méthode de AddRange ou d'Clear pour ajouter ou supprimer toutes les formes de la collection.

Vous pouvez déterminer si Shape est membre de la collection en passant la forme dans la méthode d'Contains. Pour obtenir la valeur de l'emplacement d'une forme dans la collection, passez la forme dans la méthode d'IndexOf. Vous pouvez copier la collection dans un tableau en appelant la méthode de CopyTo.

Exemples

L'exemple de code suivant supprime Shape d'ShapeCollection d'un formulaire s'il s'agit d'un membre de la collection. L'exemple exige que vous avez LineShape, OvalShape, et un contrôle d'RectangleShape sur un formulaire. Lorsqu'une forme est cliquez sur, elle est supprimée d'ShapeCollection sauf s'il s'agit de la dernière forme dans la collection.

Private Sub Shapes_Click(
    ByVal sender As System.Object, 
    ByVal e As System.EventArgs
  ) Handles RectangleShape1.Click, 
            OvalShape1.Click, LineShape1.Click

    ' Determine whether the shape is in the collection. 
    If ShapeContainer1.Shapes.Contains(sender) Then 
        ' If the Index is greater than 0, remove the shape. 
        If ShapeContainer1.Shapes.IndexOf(sender) > 0 Then
            ShapeContainer1.Shapes.Remove(sender)
        End If 
    End If 
End Sub

private void Shapes_Click(System.Object sender, System.EventArgs e)
{
    // Determine whether the shape is in the collection. 
    if (shapeContainer1.Shapes.Contains((Shape)sender))
    // If the Index is greater than 0, remove the shape.
    {
        if (shapeContainer1.Shapes.IndexOf((Shape)sender) > 0)
        {
            shapeContainer1.Shapes.Remove((Shape)sender);
        }
    }
}

Sécurité des threads

Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.