ShapeCollection.IndexOfKey, méthode

Article
11/15/2012

Extrait l'index de la première occurrence de l'élément spécifié dans la collection.

Espace de noms : Microsoft.VisualBasic.PowerPacks
Assembly : Microsoft.VisualBasic.PowerPacks.Vs (dans Microsoft.VisualBasic.PowerPacks.Vs.dll)

Syntaxe

'Déclaration
Public Function IndexOfKey ( _
    key As String _
) As Integer

public int IndexOfKey(
    string key
)

public:
int IndexOfKey(
    String^ key
)

member IndexOfKey : 
        key:string -> int

public function IndexOfKey(
    key : String
) : int

Paramètres

key
Type : System.String
Le nom de la forme à la rechercher pour.

Valeur de retour

Type : System.Int32
L'index de base zéro de la première occurrence de la forme qui a le nom spécifié dans la collection.

Notes

La comparaison principale ne respecte pas la casse sensible à la casse.Si le paramètre d'key est une référence null (Nothing en Visual Basic) ou une chaîne vide, ou un élément avec la clé spécifiée est introuvable, des retours d'IndexOfKey -1.

La propriété d'Name d'Shape est identique à la clé pour Shape dans ShapeCollection.

Exemples

L'exemple de code suivant montre comment utiliser la méthode d'IndexOfKey pour extraire l'emplacement d'Shape dans ShapeCollection.Cet exemple requiert que vous avez au moins deux contrôles d'OvalShape sur un formulaire.

Private Sub OvalShape1_Click() Handles OvalShape1.Click
    Dim i As Integer
    ' Find the index for OvalShape1.
    i = OvalShape1.Parent.Shapes.IndexOfKey("OvalShape2")
    ' If the shape is not in the collection, display a message.
    If i = -1 Then
        MsgBox("OvalShape2 is not in this collection.")
    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.IndexOfKey("ovalShape2");
    // If the shape is not in the collection, display a message.
    if (i == -1)
    {
        MessageBox.Show("ovalShape2 is not in this collection.");
    }
}

Sécurité .NET Framework

Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, consultez Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.