ShapeCollection-Klasse

Artikel
05/16/2015

Stellt eine Auflistung von Shape-Objekten dar.

Vererbungshierarchie

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 der Formen in der Auflistung ab.
	IsReadOnly	Ruft einen Wert ab, der angibt, ob eine Auflistung schreibgeschützt ist.
	Item	Ruft die Shape an der angegebenen indizierten Position in der Auflistung ab.
	Owner	Ruft den ShapeContainer ab, der die ShapeCollection besitzt.

Zum Seitenanfang

Methoden

	Name	Beschreibung
	Add	Fügt dem ShapeCollection die angegebene Shape hinzu.
	AddRange	Fügt der ShapeCollection ein Array von Shape-Objekten hinzu.
	Clear	Entfernt alle Formen aus der Auflistung.
	Contains	Bestimmt, ob die angegebene Shape ein Member der Sammlung 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, wobei 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 im ShapeCollection ab.
	GetChildIndex(Shape, Boolean)	Ruft den Index der angegebenen Shape in der ShapeCollection ab und löst optional eine Ausnahme aus, wenn die angegebene Shape nicht in der ShapeCollection ist.
	GetEnumerator	Ruft einen Verweis auf ein Enumeratorobjekt ab, das zum Durchlaufen einer ShapeCollection verwendet wird.
	GetHashCode	Fungiert als die Standardhashfunktion. (Von Object geerbt.)
	GetType	Ruft den Type der aktuellen Instanz ab. (Von Object geerbt.)
	IndexOf	Ruft den Index des angegebenen Shape im ShapeCollection ab.
	IndexOfKey	Ruft den Index des ersten Vorkommens des angegebenen Elements innerhalb der Auflistung ab.
	Remove	Entfernt das angegebene Shape aus der ShapeCollection.
	RemoveAt	Entfernt eine Shape am angegebenen Speicherort des Index aus der ShapeCollection.
	SetChildIndex	Legt den Index des angegebenen Shape im ShapeCollection auf den angegebenen Indexwert 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, Remove und RemoveAt-Methoden ermöglichen es Ihnen, Einzelpersonenformen aus der Auflistung hinzuzufügen und zu entfernen. Sie können die Methode AddRange oder Clear auch verwenden, um alle Formen aus der Auflistung hinzuzufügen oder zu entfernen.

Sie können bestimmen, ob die Shape ein Member der Auflistung ist, indem die Form in die Contains-Methode übergeben. Um den Indexwert des Speicherorts einer Form in der Sammlung 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 entfernt Shape von ShapeCollection eines Formulars, wenn ein Member der Auflistung ist. Das Beispiel erfordert, dass Sie LineShape, OvalShape und ein RectangleShape-Steuerelement auf ein Formular verfügen. Wenn auf eine Form geklickt wird, wird sie aus ShapeCollection entfernt, es sei denn, der die letzte Form in der Auflistung 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.