ShapeCollection.GetChildIndex 方法 (Shape, Boolean)

项目
10/25/2012

因此，如果指定的 Shape 不在 ShapeCollection，检索指定的 Shape 的索引。 ShapeCollection的并可以选择是否引发异常。

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

语法

声明
Public Function GetChildIndex ( _
    child As Shape, _
    throwException As Boolean _
) As Integer

public int GetChildIndex(
    Shape child,
    bool throwException
)

public:
int GetChildIndex(
    Shape^ child, 
    bool throwException
)

member GetChildIndex : 
        child:Shape * 
        throwException:bool -> int

public function GetChildIndex(
    child : Shape, 
    throwException : boolean
) : int

参数

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

throwException
类型：System.Boolean
如果 child 参数中指定的 Shape 不是 ShapeCollection 中的控件即引发异常，则为 true；否则为 false。

返回值

类型：System.Int32
表示指定的 Shape 位置。 ShapeCollection的一个从零开始的索引值。或 -1; 如果指定的 Shape 在 ShapeCollection未找到。

异常

异常	条件
ArgumentException	child 形状不在 ShapeCollection ，并 throwException 参数值是 true。

备注

索引表示形状添加到集合的顺序。如果形状从集合中移除，重新分配形状的索引。

只有当 throwException 参数为 false 时，才会返回值 -1。

示例

下面的代码示例演示如何使用 GetChildIndex 方法检索 Shape 的位置。 ShapeCollection的。此示例要求窗体的至少有两个 OvalShape 控件。

Private Sub OvalShape1_Click() Handles OvalShape1.Click
    Dim i As Integer
    ' Find the index for OvalShape1.
    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
        MsgBox("The index for OvalShape2 is " & CStr(i))
    End If
End Sub

private void ovalShape1_Click(System.Object sender, System.EventArgs e)
{
    int i;
    // Find the index for OvalShape1.
    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
    {
        String index;
        index = i.ToString();
        MessageBox.Show("The index for ovalShape2 is " + index);
    }
}