Metodo ShapeCollection.GetChildIndex (Shape, Boolean)

Articolo
05/16/2015

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.

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

Sintassi

'Dichiarazione
Public Function GetChildIndex ( _
    child As Shape, _
    throwException As Boolean _
) As Integer

public int GetChildIndex(
    Shape child,
    bool throwException
)

public:
int GetChildIndex(
    Shape^ child, 
    bool throwException
)

member GetChildIndex : 
        child:Shape * 
        throwException:bool -> int

public function GetChildIndex(
    child : Shape, 
    throwException : boolean
) : int

Parametri

child
Tipo: Microsoft.VisualBasic.PowerPacks.Shape

Oggetto Shape da cercare in ShapeCollection.

throwException
Tipo: Boolean

true per generare un'eccezione se il controllo Shape specificato nel parametro child non è un controllo dell'insieme ShapeCollection; in caso contrario, false.

Valore restituito

Tipo: Int32
Valore di indice in base zero che rappresenta il percorso del controllo Shape specificato nella raccolta ShapeCollection.Oppure -1 se Shape specificato non si trova in ShapeCollection.

Eccezioni

Eccezione	Condizione
ArgumentException	La forma di tipo child non si trova nell'oggetto ShapeCollection e il valore del parametro throwException è true.

Note

L'indice rappresenta l'ordine in cui le forme sono stati aggiunti alla raccolta. Se le forme vengono rimosse dalla raccolta, indici di forme vengano riposizionati.

Viene restituito il valore -1 solo quando il parametro throwException è false.

Esempi

Nell'esempio di codice seguente viene illustrato come utilizzare il metodo di GetChildIndex per recuperare la posizione di Shape in ShapeCollection. Questo esempio è necessario disporre di almeno due controlli di OvalShape in un form.

Private Sub OvalShape1_Click() Handles OvalShape1.Click
    Dim i As Integer 
    ' Find the index for OvalShape1.
    i = OvalShape1.Parent.Shapes.GetChildIndex(OvalShape2, False)
    ' If the shape is not in the collection, display a message. 
    If i = -1 Then
        MsgBox("OvalShape2 is not in this collection.")
    Else
        MsgBox("The index for OvalShape2 is " & CStr(i))
    End If 
End Sub

private void ovalShape1_Click(System.Object sender, System.EventArgs e)
{
    int i;
    // Find the index for OvalShape1.
    i = ovalShape1.Parent.Shapes.GetChildIndex(ovalShape2, false);
    // If the shape is not in the collection, display a message. 
    if (i==-1)
    {
        MessageBox.Show("ovalShape2 is not in this collection.");
    }
    else
    {
        String index;
        index = i.ToString();
        MessageBox.Show("The index for ovalShape2 is " + index);
    }
}

Sicurezza di .NET Framework

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per altre informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.