NamedRange.AutoComplete, méthode (System 2007)

Article
09/04/2008

Mise à jour : novembre 2007

Obtient une correspondance de saisie automatique dans la liste.

Espace de noms : Microsoft.Office.Tools.Excel
Assembly : Microsoft.Office.Tools.Excel.v9.0 (dans Microsoft.Office.Tools.Excel.v9.0.dll)

Syntaxe

Public Function AutoComplete ( _
    String As String _
) As String

Dim instance As NamedRange
Dim String As String
Dim returnValue As String

returnValue = instance.AutoComplete(String)

public string AutoComplete(
    string String
)

Paramètres

String
Type : System.String

Chaîne à compléter.

Valeur de retour

Type : System.String

Correspondance de saisie automatique de la liste.

Notes

S'il n'existe aucune correspondance de saisie automatique ou si plusieurs entrées de la liste correspondent à la chaîne à compléter, cette méthode retourne une chaîne vide.

Cette méthode fonctionne même si la fonctionnalité de saisie automatique est désactivée.

Exemples

L'exemple de code suivant illustre l'utilisation de la méthode AutoComplete. L'exemple affecte d'abord la chaîne "Martha lives on a vineyard" à la valeur de la cellule A1, puis crée un contrôle NamedRange dans la cellule A2. Il utilise ensuite la méthode AutoComplete pour obtenir une correspondance de saisie automatique à partir de la sous-chaîne "Ma" et place la valeur correspondante dans NamedRange.

Cet exemple illustre une personnalisation au niveau du document.

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();
    }
}

Autorisations

Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, consultez Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.

Voir aussi

Référence

NamedRange, classe

Membres NamedRange

Microsoft.Office.Tools.Excel, espace de noms

Share via