Metodo ShapeCollection.IndexOfKey

Articolo
05/16/2015

Recupera l'indice della prima occorrenza dell'elemento specificato nella raccolta.

Spazio dei nomi: Microsoft.VisualBasic.PowerPacks
Assembly: Microsoft.VisualBasic.PowerPacks.Vs (in Microsoft.VisualBasic.PowerPacks.Vs.dll)

Sintassi

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

Parametri

key
Tipo: String

Nome della forma di cui eseguire la ricerca.

Valore restituito

Tipo: Int32
Indice in base zero della prima occorrenza della forma con il nome specificato nella raccolta.

Note

Il confronto principale non viene applicata la distinzione tra maiuscole e minuscole. Se il parametro di key è un riferimento null (Nothing in Visual Basic) o una stringa vuota, o un elemento alla chiave specificata non viene trovato, il metodo restituisce IndexOfKey -1.

La proprietà di Name di Shape è la stessa chiave per Shape in ShapeCollection.

Esempi

Nell'esempio di codice seguente viene illustrato come utilizzare il metodo di IndexOfKey per recuperare la posizione di Shape in ShapeCollection. Questo esempio è necessario disporre di almeno due controlli di OvalShape in un form.

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

Sicurezza di .NET Framework

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per altre informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.