ShapeCollection.SetChildIndex, méthode

Article
11/15/2012

Définit l'index d'Shape spécifié dans ShapeCollection à la valeur d'index spécifiée.

Espace de noms : Microsoft.VisualBasic.PowerPacks
Assembly : Microsoft.VisualBasic.PowerPacks.Vs (dans Microsoft.VisualBasic.PowerPacks.Vs.dll)

Syntaxe

'Déclaration
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
)

Paramètres

child
Type : Microsoft.VisualBasic.PowerPacks.Shape
Shape à rechercher.

newIndex
Type : System.Int32
La nouvelle valeur d'index d'Shape.

Exceptions

Exception	Condition
ArgumentException	La forme d'child n'est pas dans ShapeCollection.

Notes

Lorsque SetChildIndex est appelé, Shape référencé par le paramètre d'child est déplacé à la position spécifiée par newIndex.Les autres références d'Shape dans ShapeCollection sont commandées de nouveau pour autoriser le déplacement.

Exemples

L'exemple suivant montre comment utiliser la méthode d'SetChildIndex pour modifier l'index d'Shape dans ShapeCollection.Cet exemple requiert que vous avez au moins deux contrôles d'OvalShape sur un formulaire.

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

Sécurité .NET Framework

Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, consultez Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.