Método NamedRange.AutoComplete

Artigo
08/01/2011

Obtém uma AutoConclusão coincidente da lista.

Namespace: Microsoft.Office.Tools.Excel
Assembly: Microsoft.Office.Tools.Excel (em Microsoft.Office.Tools.Excel.dll)

Sintaxe

'Declaração
Function AutoComplete ( _
    String As String _
) As String

string AutoComplete(
    string String
)

Parâmetros

String
Tipo: System.String
A seqüência de caracteres para concluir.

Valor de retorno

Tipo: System.String
Uma AutoConclusão coincidente da lista.

Comentários

Se não houver nenhuma correspondência de AutoCompletar ou para concluir a seqüência de caracteres corresponde a mais de uma entrada na lista, esse método retorna uma seqüência vazia.

Esse método funciona mesmo se o recurso AutoCompletar está desabilitado.

Exemplos

O exemplo de código a seguir demonstra como usar o AutoComplete método. Em primeiro lugar, o exemplo define o valor da célula A1 da cadeia de caracteres "Marta reside em uma colina" e cria um NamedRange o controle na célula A2. O exemplo usa o AutoComplete método para obter uma AutoConclusão coincidente da subseqüência de caracteres "Ma" e coloca o valor correspondente a NamedRange.

Este exemplo é para uma personalização em nível de documento.

    Private Sub FindMarthaInTheRange()
        Me.Range("A1").Value2 = "Martha lives on a vineyard"

        Dim namedRange1 As Microsoft.Office.Tools.Excel.NamedRange _
            = Me.Controls.AddNamedRange(Me.Range("A2"), _
            "namedRange1")

        namedRange1.AddComment("This is Martha's range.")
        namedRange1.Value2 = namedRange1.AutoComplete("Ma")

        If MessageBox.Show("Clear the range?", "Test", _
            MessageBoxButtons.YesNo) = DialogResult.Yes Then
            namedRange1.Clear()
        End If
    End Sub

private void FindMarthaInTheRange()
{
    this.Range["A1", missing].Value2 = "Martha lives on a vineyard";

    Microsoft.Office.Tools.Excel.NamedRange namedRange1 =
        this.Controls.AddNamedRange(this.Range["A2", missing],
        "namedRange1");

    namedRange1.AddComment("This is Martha's range.");
    namedRange1.Value2 = namedRange1.AutoComplete("Ma");

    if (MessageBox.Show("Clear the range?", "Test",
        MessageBoxButtons.YesNo) == DialogResult.Yes)
    {
        namedRange1.Clear();
    }
}

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.

Consulte também

Referência

NamedRange Interface

Namespace Microsoft.Office.Tools.Excel

Compartilhar via