Freigeben über


NamedRange.AutoComplete-Methode

Ruft eine AutoVervollständigen-Übereinstimmung aus der Liste ab.

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

Syntax

'Declaration
Function AutoComplete ( _
    String As String _
) As String
string AutoComplete(
    string String
)

Parameter

  • String
    Typ: System.String
    Die zu vervollständigende Zeichenkette.

Rückgabewert

Typ: System.String
Eine AutoVervollständigen-Übereinstimmung aus der Liste.

Hinweise

Wenn es keine AutoVervollständigen-Übereinstimmung gibt, oder wenn es mehr als einen Eintrag in der Liste gibt, der mit der zu vervollständigenden Zeichenfolge übereinstimmt, gibt diese Methode eine leere Zeichenfolge zurück.

Diese Methode funktioniert sogar, wenn das AutoVervollständigen-Feature deaktiviert ist.

Beispiele

Im folgenden Codebeispiel wird die Verwendung der AutoComplete-Methode veranschaulicht.Zunächst wird in diesem Beispiel der Wert der Zelle A1 auf die Zeichenfolge "Martha lives on a vineyard" festgelegt, und es wird in Zelle A2 ein NamedRange-Steuerelement erstellt.Anschließend wird in diesem Beispiel mithilfe der AutoComplete-Methode eine AutoVervollständigen-Übereinstimmung mit der untergeordneten Zeichenfolge "Ma" abgerufen und der übereinstimmende Wert in dem NamedRange platziert.

Dieses Beispiel bezieht sich auf eine Anpassung auf Dokumentebene.

    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"].Value2 = "Martha lives on a vineyard";

    Microsoft.Office.Tools.Excel.NamedRange namedRange1 =
        this.Controls.AddNamedRange(this.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)
    {
        namedRange1.Clear();
    }
}

.NET Framework-Sicherheit

Siehe auch

Referenz

NamedRange Schnittstelle

Microsoft.Office.Tools.Excel-Namespace