ShapeCollection.IndexOfKey (Método)

Recupera el índice de la primera aparición del elemento especificado de la colección.

Espacio de nombres: Microsoft.VisualBasic.PowerPacks
Ensamblado: Microsoft.VisualBasic.PowerPacks.Vs (en Microsoft.VisualBasic.PowerPacks.Vs.dll)

Sintaxis

'Declaración
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

Parámetros

key
Tipo: System.String
El nombre de la forma que se busca.

Valor devuelto

Tipo: System.Int32
El índice de base cero de la primera aparición de la forma que tiene el nombre especificado de la colección.

Comentarios

La comparación de clave no distingue entre mayúsculas y minúsculas.Si el parámetro de key es una referencia nula (Nothing en Visual Basic) o una cadena vacía, o un elemento con la clave especificada no se encuentra, IndexOfKey devuelve -1.

La propiedad de Name de Shape es igual que la clave de Shape en ShapeCollection.

Ejemplos

El ejemplo de código siguiente muestra cómo utilizar el método de IndexOfKey para recuperar la ubicación de Shape en ShapeCollection.Este ejemplo requiere que tenga al menos dos controles de OvalShape en un formulario.

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

Seguridad de .NET Framework

Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.