Classe ShapeCollection

Rappresenta una raccolta di Shape oggetti.

Gerarchia di ereditarietà

System.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
Metodo pubblico ShapeCollection Inizializza una nuova istanza di ShapeCollection classe.

In alto

Proprietà

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

In alto

Metodi

  Nome Descrizione
Metodo pubblico Add aggiunge specificato Shape in ShapeCollection.
Metodo pubblico AddRange aggiunge una matrice di Shape oggetti a ShapeCollection.
Metodo pubblico Clear Rimuove tutte le forme dalla raccolta.
Metodo pubblico Contains determina se specificato Shape è un membro della raccolta.
Metodo pubblico ContainsKey determina se ShapeCollection contiene un elemento con la chiave specificata.
Metodo pubblico CopyTo copia il tutto ShapeCollection a un unidimensionale compatibile Array, partendo dall'indice specificato della matrice di destinazione.
Metodo pubblico Dispose Rilascia risorse non gestite utilizzate da ShapeCollection.
Metodo pubblico Equals Determina se l'oggetto specificato equivale all'oggetto corrente. (Ereditato da Object)
Metodo pubblico GetChildIndex(Shape) Recupera l'indice della classe specificata Shape in ShapeCollection.
Metodo pubblico GetChildIndex(Shape, Boolean) Recupera l'indice della classe specificata Shape in ShapeCollectione facoltativamente genera un'eccezione se specificato Shape non è in ShapeCollection.
Metodo pubblico GetEnumerator Recupera un riferimento a un oggetto enumerator utilizzato per scorrere un oggetto ShapeCollection.
Metodo pubblico GetHashCode Funge da funzione hash per un determinato tipo. (Ereditato da Object)
Metodo pubblico GetType Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
Metodo pubblico IndexOf Recupera l'indice della classe specificata Shape in ShapeCollection.
Metodo pubblico IndexOfKey Recupera l'indice della prima occorrenza dell'elemento specificato della raccolta.
Metodo pubblico Remove rimuove specificato Shape da ShapeCollection.
Metodo pubblico RemoveAt Rimuove un oggetto Shape da ShapeCollection la posizione indicizzata specificata.
Metodo pubblico SetChildIndex Imposta l'indice della classe specificata Shape in ShapeCollection il valore di indice specificato.
Metodo pubblico ToString Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

In alto

Implementazioni esplicite dell'interfaccia

  Nome Descrizione
Implementazione esplicita dell'interfacciaMetodo privato IList.Add
Implementazione esplicita dell'interfacciaMetodo privato IList.Contains
Implementazione esplicita dell'interfacciaMetodo privato ICollection.CopyTo
Implementazione esplicita dell'interfacciaMetodo privato IList.IndexOf
Implementazione esplicita dell'interfacciaMetodo privato IList.Insert
Implementazione esplicita dell'interfacciaProprietà privata IList.IsFixedSize
Implementazione esplicita dell'interfacciaProprietà privata ICollection.IsSynchronized
Implementazione esplicita dell'interfacciaMetodo privato IList.Remove
Implementazione esplicita dell'interfacciaProprietà privata ICollection.SyncRoot

In alto

Note

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

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

Esempi

Nell'esempio di codice rimuove un oggetto Shape da ShapeCollection di un form se è un membro della raccolta.Si presuppone che l'utente abbia a LineShape, OvalShapee RectangleShape controllare in un form.Quando una forma è selezionata, verrà rimossa da ShapeCollection a meno che non sia l'ultimo il form 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)