ShapeCollection.SetChildIndex-Methode

Artikel
10/24/2012

Legt den Index des angegebenen Shape dem angegebenen Indexwert in ShapeCollection fest.

Namespace: Microsoft.VisualBasic.PowerPacks
Assembly: Microsoft.VisualBasic.PowerPacks.Vs (in Microsoft.VisualBasic.PowerPacks.Vs.dll)

Syntax

'Declaration
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
)

Parameter

child
Typ: Microsoft.VisualBasic.PowerPacks.Shape
Die zu suchende Shape.

newIndex
Typ: System.Int32
Der neue Indexwert Shape.

Ausnahmen

Ausnahme	Bedingung
ArgumentException	Die child Form befindet sich nicht in ShapeCollection.

Hinweise

Wenn SetChildIndex aufgerufen wird, wird Shape , das durch den child-Parameter verweist auf die Position verschoben, die von newIndexangegeben wird.Die anderen Shape References in ShapeCollection werden neu angeordnet, um die Verschiebung zu ermöglichen.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie die SetChildIndex-Methode verwendet, um den Index eines Shape in ShapeCollectionzu ändern.Dieses Beispiel setzt voraus, dass Sie mindestens zwei OvalShape-Steuerelementen auf einem Formular verfügen.

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

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.