TextBox.AutoCompleteMode Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Dient zum Abrufen oder Festlegen einer Option, die steuert, wie die automatische Fertigstellung für die TextBox.
public:
property System::Windows::Forms::AutoCompleteMode AutoCompleteMode { System::Windows::Forms::AutoCompleteMode get(); void set(System::Windows::Forms::AutoCompleteMode value); };[System.ComponentModel.Browsable(true)]
public System.Windows.Forms.AutoCompleteMode AutoCompleteMode { get; set; }[<System.ComponentModel.Browsable(true)>]
member this.AutoCompleteMode : System.Windows.Forms.AutoCompleteMode with get, setPublic Property AutoCompleteMode As AutoCompleteModeEigenschaftswert
Einer der Werte von AutoCompleteMode. Im Folgenden sind die Werte aufgeführt.
Append Fügt den Rest der wahrscheinlichsten Kandidatenzeichenfolge an die vorhandenen Zeichen an, wobei die angefügten Zeichen hervorgehoben werden.
Suggest Zeigt die hilfsbasierte Dropdownliste an, die dem Bearbeitungssteuerelement zugeordnet ist. Diese Dropdownliste wird mit einer oder mehreren vorgeschlagenen Abschlusszeichenfolgen ausgefüllt.
SuggestAppend Fügt beide Suggest Optionen und Append Optionen an.
None Deaktiviert den automatischen Abschluss. Dies ist die Standardoption.
- Attribute
Ausnahmen
Der angegebene Wert ist nicht einer der Werte von AutoCompleteMode.
Beispiele
Im folgenden Codebeispiel wird veranschaulicht, wie eine Auflistung als benutzerdefinierte Quelle für ein TextBox Steuerelement verwendet wird. In diesem Beispiel werden die folgenden Aufgaben ausgeführt:
Verwendet die AutoCompleteSource Eigenschaft, um das TextBox Steuerelement zu aktivieren, um eine benutzerdefinierte Quelle für sein autovervollständigen Verhalten zu akzeptieren.
Verwendet die AutoCompleteCustomSource Eigenschaft, um die benutzerdefinierte Liste der Werte festzulegen.
Verwendet die AutoCompleteMode Eigenschaft, um festzulegen, wie die automatisch abgeschlossenen Kandidaten angezeigt werden.
private void Form1_Load(object sender, EventArgs e)
{
// Create the list to use as the custom source.
var source = new AutoCompleteStringCollection();
source.AddRange(new string[]
{
"January",
"February",
"March",
"April",
"May",
"June",
"July",
"August",
"September",
"October",
"November",
"December"
});
// Create and initialize the text box.
var textBox = new TextBox
{
AutoCompleteCustomSource = source,
AutoCompleteMode =
AutoCompleteMode.SuggestAppend,
AutoCompleteSource =
AutoCompleteSource.CustomSource,
Location = new Point(20, 20),
Width = ClientRectangle.Width - 40,
Visible = true
};
// Add the text box to the form.
Controls.Add(textBox);
}
Private Sub Form1_Load(ByVal sender As System.Object, _
ByVal e As System.EventArgs) Handles MyBase.Load
' Create the list to use as the custom source.
Dim MySource As New AutoCompleteStringCollection()
MySource.AddRange(New String() _
{ _
"January", _
"February", _
"March", _
"April", _
"May", _
"June", _
"July", _
"August", _
"September", _
"October", _
"November", _
"December" _
})
' Create and initialize the text box.
Dim MyTextBox As New TextBox()
With MyTextBox
.AutoCompleteCustomSource = MySource
.AutoCompleteMode = AutoCompleteMode.SuggestAppend
.AutoCompleteSource = AutoCompleteSource.CustomSource
.Location = New Point(20, 20)
.Width = Me.ClientRectangle.Width - 40
.Visible = True
End With
' Add the text box to the form.
Me.Controls.Add(MyTextBox)
End Sub
Hinweise
Verwenden Sie die AutoCompleteCustomSourceEigenschaften , AutoCompleteModeum AutoCompleteSource ein TextBox Objekt zu erstellen, das Eingabezeichenfolgen automatisch abschließt, indem Sie das Präfix vergleichen, das mit den Präfixen aller Zeichenfolgen in einer verwalteten Quelle eingegeben wird. Dies ist nützlich für TextBox Steuerelemente, in denen URLs, Adressen, Dateinamen oder Befehle häufig eingegeben werden.
Die Verwendung der AutoCompleteCustomSource Eigenschaft ist optional, aber Sie müssen die AutoCompleteSource Eigenschaft so festlegen, dass CustomSource sie verwendet werden soll AutoCompleteCustomSource.
Sie müssen die Eigenschaften und AutoCompleteSource die AutoCompleteMode Eigenschaften zusammen verwenden.
Hinweis
Das Betriebssystem kann die Anzahl der benutzerdefinierten Zeichenfolgen einschränken, die gleichzeitig angezeigt werden können.
