Metodo ShapeCollection.GetChildIndex (Shape, Boolean)

Articolo
10/30/2012

Recupera l'indice della classe specificata Shape in ShapeCollectione facoltativamente genera un'eccezione se specificato Shape non è 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
Shape per trovare in ShapeCollection.

throwException
Tipo: System.Boolean
true per generare un'eccezione qualora Shape specificato in child il parametro non è un controllo in ShapeCollection; in caso contrario, false.

Valore restituito

Tipo: System.Int32
Un valore di indice a base zero che rappresenta la posizione del specificato Shape in ShapeCollection.Oppure -1 se specificato Shape non viene rilevato in ShapeCollection.

Eccezioni

Eccezione	Condizione
ArgumentException	child la forma non è in ShapeCollection e throwException il valore del parametro è true.

Note

L'indice rappresenta l'ordine in cui le forme è stata aggiunta alla raccolta.Se le forme vengono rimosse dalla raccolta, gli indici delle forme vengono riposizionati.

Un valore restituito di -1 viene restituito solo quando throwException il parametro è false.

Esempi

Nell'esempio di codice seguente viene illustrato come utilizzare GetChildIndex metodo per recuperare la posizione di un oggetto Shape in ShapeCollection.Questo esempio richiede la presenza di almeno due OvalShape controlli 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 ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.