ShapeCollection-Klasse

Artikel
10/24/2012

Stellt eine Auflistung von Shape-Objekten dar.

Vererbungshierarchie

System.Object
Microsoft.VisualBasic.PowerPacks.ShapeCollection

Namespace: Microsoft.VisualBasic.PowerPacks
Assembly: Microsoft.VisualBasic.PowerPacks.Vs (in Microsoft.VisualBasic.PowerPacks.Vs.dll)

Syntax

'Declaration
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

Der ShapeCollection-Typ macht die folgenden Member verfügbar.

Konstruktoren

	Name	Beschreibung
	ShapeCollection	Initialisiert eine neue Instanz der ShapeCollection-Klasse.

Zum Seitenanfang

Eigenschaften

	Name	Beschreibung
	Count	Ruft die Anzahl von Formen in der Auflistung ab.
	IsReadOnly	Ruft einen Wert ab, der angibt, ob eine Auflistung schreibgeschützt ist.
	Item	Ruft Shape an der angegebenen indizierten Position in der Auflistung ab.
	Owner	Ruft ShapeContainer ab, das ShapeCollectionbesitzt.

Zum Seitenanfang

Methoden

	Name	Beschreibung
	Add	Fügt dem ShapeCollection die angegebene Shape hinzu.
	AddRange	Fügt ein Array ShapeShapeCollectionObjekte hinzu.
	Clear	Entfernt alle Formen aus der Auflistung.
	Contains	Bestimmt, ob das angegebene Shape ein Member der Auflistung ist.
	ContainsKey	Ermittelt, ob die ShapeCollection ein Element mit dem angegebenen Schlüssel enthält.
	CopyTo	Kopiert die gesamte ShapeCollection in ein kompatibles eindimensionales Array, beginnend am angegebenen Index des Zielarrays.
	Dispose	Gibt die von ShapeCollection verwendeten, nicht verwalteten Ressourcen frei.
	Equals	Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist. (Von Object geerbt.)
	GetChildIndex(Shape)	Ruft den Index des angegebenen Shape in ShapeCollectionab.
	GetChildIndex(Shape, Boolean)	Ruft den Index des angegebenen Shape in ShapeCollectionab und löst optional eine Ausnahme aus, wenn der angegebene Shape nicht in ShapeCollectionist.
	GetEnumerator	Ruft einen Verweis auf ein Enumeratorobjekt ab, das zum Durchlaufen einer ShapeCollection verwendet wird.
	GetHashCode	Fungiert als Hashfunktion für einen bestimmten Typ. (Von Object geerbt.)
	GetType	Ruft den Type der aktuellen Instanz ab. (Von Object geerbt.)
	IndexOf	Ruft den Index des angegebenen Shape in ShapeCollectionab.
	IndexOfKey	Ruft den Index des ersten Vorkommens des angegebenen Elements in der Auflistung ab.
	Remove	Entfernt den angegebenen Shape aus der ShapeCollection.
	RemoveAt	Entfernt Shape von ShapeCollection an der angegebenen indizierten Position.
	SetChildIndex	Legt den Index des angegebenen Shape dem angegebenen Indexwert in ShapeCollection fest.
	ToString	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Von Object geerbt.)

Zum Seitenanfang

Explizite Schnittstellenimplementierungen

	Name	Beschreibung
	IList.Add
	IList.Contains
	ICollection.CopyTo
	IList.IndexOf
	IList.Insert
	IList.IsFixedSize
	ICollection.IsSynchronized
	IList.Remove
	ICollection.SyncRoot

Zum Seitenanfang

Hinweise

Add, Removeund RemoveAt-Methoden ermöglichen Ihnen, einzelne Formen aus der Auflistung hinzuzufügen und zu entfernen.Sie können die AddRange oder Clear-Methode auch verwenden, um alle Formen aus der Auflistung hinzuzufügen oder zu entfernen.

Sie können bestimmen, ob Shape ein Member der Auflistung ist, indem Sie die Form in die Contains-Methode übergeben.Um den Indexwert des Speicherorts einer Form in der Auflistung abzurufen, führen Sie die Form in die IndexOf-Methode.Sie können die Auflistung in ein Array kopieren, indem Sie die CopyTo-Methode aufrufen.

Beispiele

Im folgenden Codebeispiel ShapeCollection eines Formulars entfernt Shape aus, wenn es ein Member der Auflistung ist.Für dieses Beispiel ist es erforderlich, dass Sie LineShape, OvalShapeund ein RectangleShape-Steuerelement in einem Formular verfügen.Wenn auf eine Form klickt, wird sie von ShapeCollection entfernt, es sei denn, die letzte Form in der Auflistung vorhanden ist.

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

Threadsicherheit

Alle öffentlichen static (Shared in Visual Basic)-Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.