ShapeCollection.IndexOfKey-Methode

Artikel
10/24/2012

Ruft den Index des ersten Vorkommens des angegebenen Elements in der Auflistung ab.

Namespace: Microsoft.VisualBasic.PowerPacks
Assembly: Microsoft.VisualBasic.PowerPacks.Vs (in Microsoft.VisualBasic.PowerPacks.Vs.dll)

Syntax

'Declaration
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

Parameter

key
Typ: System.String
Der Name der zu suchenden Form.

Rückgabewert

Typ: System.Int32
Der nullbasierte Index des ersten Vorkommens der Form, die den angegebenen Namen in der Auflistung.

Hinweise

Der Schlüssel ist bei der die Groß-/Kleinschreibung nicht beachtet.Wenn der key-Parameter ein NULL-Verweis (Nothing in Visual Basic) oder eine leere Zeichenfolge ist oder ein Element mit dem angegebenen Schlüssel nicht gefunden wird, IndexOfKey -1 zurückgibt.

Die Name-Eigenschaft von Shape ist identisch mit der Schlüssel für Shape in ShapeCollection.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die IndexOfKey-Methode verwendet, um den Speicherort von Shape in ShapeCollectionabzurufen.Dieses Beispiel setzt voraus, dass Sie mindestens zwei OvalShape-Steuerelementen auf einem Formular verfügen.

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

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.