Classe ShapeCollection

Rappresenta una raccolta di oggetti Shape.

Gerarchia di ereditarietà

Object
  Microsoft.VisualBasic.PowerPacks.ShapeCollection

Spazio dei nomi:  Microsoft.VisualBasic.PowerPacks
Assembly:  Microsoft.VisualBasic.PowerPacks.Vs (in Microsoft.VisualBasic.PowerPacks.Vs.dll)

Sintassi

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

Il tipo ShapeCollection espone i seguenti membri.

Costruttori

	Nome	Descrizione
	ShapeCollection	Inizializza una nuova istanza della classe ShapeCollection.

In alto

Proprietà

	Nome	Descrizione
	Count	Ottiene il numero di forme nella raccolta.
	IsReadOnly	Ottiene un valore che indica se una raccolta è di sola lettura.
	Item	Ottiene Shape nella posizione indicizzata specificata della raccolta.
	Owner	Ottiene ShapeContainer che possiede ShapeCollection.

In alto

Metodi

	Nome	Descrizione
	Add	Aggiunge l'oggetto Shape specificato all'insieme ShapeCollection.
	AddRange	Aggiunge una matrice di oggetti Shape all'oggetto ShapeCollection.
	Clear	Rimuove tutte le forme dalla raccolta.
	Contains	Determina se l'elemento specificato Shape è un membro della raccolta.
	ContainsKey	Determina se l'oggetto ShapeCollection contiene un elemento con la chiave specificata.
	CopyTo	Copia l'intero ShapeCollection in un oggetto Array compatibile unidimensionale, a partire dall'indice specificato della matrice di destinazione.
	Dispose	Consente di liberare le risorse non gestite utilizzate dalla classe ShapeCollection.
	Equals	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
	GetChildIndex(Shape)	Recupera l'indice di Shape in ShapeCollection.
	GetChildIndex(Shape, Boolean)	Recupera l'indice dell'oggetto Shape specificato nell'oggetto ShapeCollection e facoltativamente genera un'eccezione se l'oggetto Shape specificato non si trova in ShapeCollection.
	GetEnumerator	Recupera un riferimento a un oggetto enumeratore utilizzato per scorrere un oggetto ShapeCollection.
	GetHashCode	Funge da funzione hash predefinita. (Ereditato da Object)
	GetType	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
	IndexOf	Recupera l'indice di Shape in ShapeCollection.
	IndexOfKey	Recupera l'indice della prima occorrenza dell'elemento specificato nella raccolta.
	Remove	Rimuove l'oggetto Shape specificato dall'oggetto ShapeCollection.
	RemoveAt	Rimuove un oggetto Shape da ShapeCollection in corrispondenza della posizione indicizzata specificata.
	SetChildIndex	Imposta l'indice dell'oggetto Shape specificato nella raccolta ShapeCollection sul valore di indice specificato.
	ToString	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

In alto

Implementazioni esplicite dell'interfaccia

	Nome	Descrizione
	IList.Add
	IList.Contains
	ICollection.CopyTo
	IList.IndexOf
	IList.Insert
	IList.IsFixedSize
	ICollection.IsSynchronized
	IList.Remove
	ICollection.SyncRoot

In alto

Note

Add, Remove e i metodi di RemoveAt consentono di aggiungere e rimuovere le forme utente dalla raccolta. È inoltre possibile utilizzare il metodo di Clear o di AddRange per aggiungere o rimuovere tutte le forme dalla raccolta.

È possibile determinare se Shape è un membro della raccolta passando la forma nel metodo di Contains. Per ottenere il valore di indice della posizione di una forma della raccolta, passare la forma nel metodo di IndexOf. È possibile copiare la raccolta in una matrice chiamando il metodo CopyTo.

Esempi

Nell'esempio di codice Shape rimuove da ShapeCollection di un form se è un membro della raccolta. Si presuppone che l'utente abbia LineShape, OvalShape e un controllo di RectangleShape in un form. Quando una forma viene selezionato, verrà rimossa da ShapeCollection a meno che non sia l'ultima forma nella raccolta.

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

Codice thread safe

Qualsiasi membro static (Shared in Visual Basic) pubblico di questo tipo è thread-safe. I membri di istanza non sono garantiti come thread-safe.

Vedere anche

Riferimenti

Spazio dei nomi Microsoft.VisualBasic.PowerPacks

Altre risorse

Introduzione ai controlli Line e Shape (Visual Studio)

Procedura: disegnare linee con il controllo LineShape (Visual Studio)

Procedura: disegnare forme con i controlli OvalShape e RectangleShape (Visual Studio)