ShapeCollection.IndexOfKey (Método)

Artículo
05/17/2015

Devuelve el índice de la primera aparición del elemento especificado en 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: String

Nombre de la forma que se va a buscar.

Valor devuelto

Tipo: Int32
Índice de base cero de la primera aparición de la forma con el nombre especificado en 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.