ShapeCollection.SetChildIndex, méthode

Article
05/16/2015

Définit l'index de la Shape spécifiée dans la 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 : Int32

Nouvelle valeur d'index de la Shape.

Exceptions

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

Notes

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

Exemples

L'exemple suivant montre comment utiliser la méthode de SetChildIndex pour modifier l'index d'Shape dans ShapeCollection. Cet exemple requiert que vous disposez d'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, voir Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.