Método ShapeCollection.IndexOfKey

Artigo
10/26/2012

Recupera o índice da primeira ocorrência do item especificado na coleção.

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

Sintaxe

'Declaração
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
O nome da forma para procurar.

Valor de retorno

Tipo: System.Int32
O índice baseado em zero da primeira ocorrência da forma que tem o nome especificado na coleção.

Comentários

A chave comparação não diferencia maiúsculas de minúsculas.Se a key parâmetro é uma referência nula (Nothing em Visual Basic) ou uma seqüência vazia ou um item com a versão especificada chave não for encontrado, IndexOfKey retornará -1.

O Name propriedade de um Shape é o mesmo que a chave para uma Shape na ShapeCollection.

Exemplos

O exemplo de código a seguir demonstra como usar o IndexOfKey método para recuperar o local de um Shape na ShapeCollection.Este exemplo requer que você tenha pelo menos duas OvalShape controles em um formulário.

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

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiáveis.