ShapeCollection, classe

Article
11/15/2012

Représente une collection d'objets Shape.

Hiérarchie d'héritage

System.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 dans la collection.
	IsReadOnly	Obtient une valeur indiquant si une collection est en lecture seule.
	Item	Obtient Shape à l'emplacement indexé spécifié dans la collection.
	Owner	Obtient ShapeContainer qui possède ShapeCollection.

Début

Méthodes

	Nom	Description
	Add	Ajoute le Shape spécifié à ShapeCollection.
	AddRange	Ajoute un tableau d'objets d'Shape à ShapeCollection.
	Clear	Supprime toutes les formes de la collection.
	Contains	Détermine si Shape spécifié est un membre de la collection.
	ContainsKey	Détermine si ShapeCollection contient un élément avec la clé spécifiée.
	CopyTo	Copie ShapeCollection entier à Array unidimensionnel compatible, en commençant à l'index spécifié de la matrice 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)	Extrait l'index d'Shape spécifié dans ShapeCollection.
	GetChildIndex(Shape, Boolean)	Extrait l'index d'Shape spécifié dans ShapeCollection, et éventuellement déclenche une exception si Shape spécifié n'est pas dans ShapeCollection.
	GetEnumerator	Récupère une référence à un objet énumérateur utilisé pour parcourir une ShapeCollection.
	GetHashCode	Sert de fonction de hachage pour un type particulier. (Hérité de Object.)
	GetType	Obtient le Type de l'instance actuelle. (Hérité de Object.)
	IndexOf	Extrait l'index d'Shape spécifié dans ShapeCollection.
	IndexOfKey	Extrait 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 Shape d'ShapeCollection à l'emplacement spécifié indexé.
	SetChildIndex	Définit l'index d'Shape spécifié dans 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 d'RemoveAt vous permettent pour ajouter et supprimer des formes individuels de la collection.Vous pouvez également utiliser la méthode d'AddRange ou d'Clear pour ajouter ou supprimer toutes les formes de la collection.

Vous pouvez déterminer si Shape est un membre de la collection en passant la forme dans la méthode d'Contains.Pour obtenir la valeur d'index de l'emplacement d'une forme dans la collection, passez la forme dans la méthode d'IndexOf.Vous pouvez copier la collection dans une matrice en appelant la méthode d'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 requiert que vous avez LineShape, OvalShape, et un contrôle d'RectangleShape sur un formulaire.Lorsqu'une forme est sélectionnée, elle est supprimée d'ShapeCollection à moins que ce soit 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.