ShapeCollection.SetChildIndex 方法

项目
10/25/2012

设置指定的 Shape 的索引。 ShapeCollection 于指定的索引值。

命名空间： Microsoft.VisualBasic.PowerPacks
程序集： Microsoft.VisualBasic.PowerPacks.Vs（在 Microsoft.VisualBasic.PowerPacks.Vs.dll 中）

语法

声明
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
)

参数

child
类型：Microsoft.VisualBasic.PowerPacks.Shape
要搜索的 Shape。

newIndex
类型：System.Int32
Shape 的新索引值。

异常

异常	条件
ArgumentException	child 形状不在 ShapeCollection。

备注

当 SetChildIndex 调用时， child 参数引用的 Shape 移到 newIndex指定的该位置。另一 Shape 在 ShapeCollection 引用重新排列允许在移动。

示例

下面的示例演示如何使用 SetChildIndex 方法更改 Shape 的索引。 ShapeCollection的。此示例要求窗体的至少有两个 OvalShape 控件。

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