ShapeCollection.IndexOfKey-Methode

Artikel
05/16/2015

Ruft den Index des ersten Vorkommens des angegebenen Elements innerhalb 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: String

Der Name der zu suchenden Form.

Rückgabewert

Typ: Int32
Der nullbasierte Index des ersten Vorkommens der Form mit dem angegebenen Namen in der Auflistung.

Hinweise

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

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

Beispiele

Das folgende Codebeispiel zeigt, wie die IndexOfKey-Methode verwendet, um den Speicherort von Shape in ShapeCollection. Dieses Beispiel erfordert, dass sich mindestens zwei OvalShape-Steuerelementen auf einem Formular befinden.

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.