ShapeCollection.IndexOfKey, méthode

Article
05/16/2015

Récupère 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 : String

Nom du champ à rechercher.

Valeur de retour

Type : Int32
Index de base zéro de la première occurrence de la forme dont le nom est spécifié dans la collection.

Notes

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

La propriété d'Name d'Shape est la même que la clé pour Shape dans ShapeCollection.

Exemples

L'exemple de code suivant montre comment utiliser la méthode de IndexOfKey pour extraire l'emplacement d'Shape dans ShapeCollection. Cet exemple requiert que vous disposez d'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, voir Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.