ShapeCollection.SetChildIndex-Methode

Artikel
05/16/2015

Legt den Index des angegebenen Shape im ShapeCollection auf den angegebenen Indexwert 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: Int32

Der neue Indexwert der Shape.

Ausnahmen

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

Hinweise

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

Beispiele

Das folgende Beispiel zeigt, wie die SetChildIndex-Methode verwendet, um den Index der Shape in ShapeCollection ändern. Dieses Beispiel erfordert, dass sich mindestens zwei OvalShape-Steuerelementen auf einem Formular befinden.

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.