Metodo ShapeCollection.SetChildIndex

Articolo
05/16/2015

Imposta l'indice dell'oggetto Shape specificato nella raccolta ShapeCollection sul valore di indice specificato.

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

Sintassi

'Dichiarazione
Public Sub SetChildIndex ( _
    child As Shape, _
    newIndex As Integer _
)

public void SetChildIndex(
    Shape child,
    int newIndex
)

public:
void SetChildIndex(
    Shape^ child, 
    int newIndex
)

member SetChildIndex : 
        child:Shape * 
        newIndex:int -> unit

public function SetChildIndex(
    child : Shape, 
    newIndex : int
)

Parametri

child
Tipo: Microsoft.VisualBasic.PowerPacks.Shape

Oggetto Shape da cercare.

newIndex
Tipo: Int32

Nuovo valore dell'indice dell'oggetto Shape.

Eccezioni

Eccezione	Condizione
ArgumentException	La forma child non è in ShapeCollection.

Note

Quando SetChildIndex viene chiamato, Shape indicato dal parametro di child viene spostato nella posizione specificata da newIndex. Gli altri riferimenti di Shape in ShapeCollection vengono riordinati per consentire lo spostamento.

Esempi

Nell'esempio seguente viene illustrato come utilizzare il metodo SetChildIndex per modificare il valore 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 OvalShape2.
    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 
        ' Change the index to 0.
        OvalShape1.Parent.Shapes.SetChildIndex(OvalShape2, 0)
    End If 
End Sub

private void ovalShape1_Click(System.Object sender, System.EventArgs e)
{
    int i;
    // Find the index for OvalShape2.
    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
    {
        // Change the index to 0.
        ovalShape1.Parent.Shapes.SetChildIndex(ovalShape2, 0);
    }
}

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.