次の方法で共有

ShapeCollection.GetChildIndex メソッド (Shape, Boolean)

  • [アーティクル]

指定 Shape が ShapeCollection にある ShapeCollection の指定 Shape のインデックスを取得し、必要に応じて例外を発生させます。

名前空間:  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

パラメーター

  • throwException
    型 : System.Boolean
    child パラメーターで指定した Shape が ShapeCollection 内のコントロールでないときに例外をスローする場合は true。それ以外の場合は false。

戻り値

型 : System.Int32
ShapeCollection の指定 Shape の位置を表すから始まるインデックス値。またはを指定 Shape が ShapeCollection にない場合は -1。

例外

例外 条件
ArgumentException

child の図形は ShapeCollection にない場合に throwException のパラメーター値は true です。

解説

インデックスは、図形がコレクションに追加された順序を表します。図形がコレクションから削除された場合、シェイプのインデックスは、再割り当てされます。

throwException パラメーターが false の場合だけ戻り値 -1 が返されます。

例

次のコード例に ShapeCollection の Shape の位置を取得するに GetChildIndex のメソッドの使用方法を示しています。この例では、フォームの少なくとも OvalShape の 2 種類のコントロールがあることが必要です。

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

.NET Framework セキュリティ

  • 直前の呼び出し元に対する完全な信頼。このメンバーは、部分的に信頼されているコードから使用することはできません。詳細については、「部分信頼コードからのライブラリの使用」を参照してください。

参照

関連項目

ShapeCollection クラス

GetChildIndex オーバーロード

Microsoft.VisualBasic.PowerPacks 名前空間

IndexOf

その他の技術情報

ライン コントロールとシェイプ コントロールの概要 (Visual Studio)

方法 : LineShape コントロールを使用して線を描画する (Visual Studio)

方法 : OvalShape コントロールおよび RectangleShape コントロールを使用して図形を描画する (Visual Studio)