ValidatingTextBox-Steuerelement

Aufgebohrte TextBox mit Funktionen zur Eingabeprüfung und Unterstützung gängiger Hotkeys zur Textbearbeitung.

Diese aufgebohrte TextBox erweitert das Standard-Steuerelement um Funktionen zur Eingabeprüfung und erlaubt die Verwendung gängiger Hotkeys zur Textbearbeitung. Sie lässt sich so konfigurieren, dass sie nur Zahleneingaben oder erlaubte Zeichen akzeptiert oder die Eingabe mit einem regulären Ausdruck prüft.

Das Steuerelement bietet diverse Optionen, um sein Verhalten zu konfigurieren:

  • Mit der Type-Eigenschaft lässt sich die Eingabeprüfung zwischen Zahleneingaben, erlaubten Zeichen, regulärem Ausdruck und benutzerdefinierter Prüfung umschalten oder zur freien Eingabe deaktivieren. Die Eigenschaften ValidCharacters und RegularExpression geben die erlaubten Zeichen bzw. den regulären Ausdruck an.
  • Mit der Eigenschaft FinalRegularExpression lässt sich zusätzlich zur Prüfung während der Eingabe ein regulärer Ausdruck angeben, der beim Verlassen des Textfelds geprüft wird. Diese Prüfung kann mit der DeferFinalCheck-Eigenschaft deaktiviert werden, um sie zu einem geeigneten Zeitpunkt mit FinalCheck() durch Benutzercode auszuführen.
  • Die Eigenschaft RequireInput legt fest, ob das Textfeld leer bleiben darf.
  • Die Eigenschaft TrimOnLeaving legt fest, ob beim Verlassen des Textfelds Leerzeichen von den Enden des eingegebenen Textes entfernt werden sollen. So gelangen unsichtbare Leerzeichen gar nicht erst in die weitere Verarbeitung und erforderliche Eingaben sind es tatsächlich.
  • Die ExpectedFormatDescription-Eigenschaft enthält eine Beschreibung des erwarteten Eingabeformats und wird in einem ToolTip unter der TextBox angezeigt, wenn der Anwender eine ungültige Eingabe vorgenommen hat.
  • Die AutoHeight-Eigenschaft legt fest, ob bei mehrzeiligen Textfeldern (MultiLine) die Höhe der TextBox bei gegebener Breite automatisch an den eingegebenen Text angepasst werden soll.

Das Steuerelement erlaubt die Verwendung folgender zusätzlicher Hotkeys (Tastenkombinationen), die in vielen Anwendungen bereits üblich sind:

  • Strg+A: Gesamte Eingabe markieren
  • Strg+U: Gesamte Eingabe löschen
  • Strg+W, Strg+Backspace: Letztes Wort vor dem Cursor löschen
  • Strg+Hoch: Bei mehrzeiligen Textfeldern eine Zeile nach oben blättern
  • Strg+Runter: Bei mehrzeiligen Textfeldern eine Zeile nach unten blättern

Kompatibilität: .NET Ab Version 2.0

Download

ValidatingTextBox.cs14,8 KiBQuelltext des ValidatingTextBox-Steuerelements

Lizenz und Nutzungsbedingungen

Vervielfältigung und Weiterverbreitung dieser Datei, verändert oder unverändert, sind gestattet, vorausgesetzt die Urheberrechtsangabe und dieser Hinweis bleiben erhalten. Diese Datei wird wie vorliegend ohne jegliche Garantie oder Gewährleistung angeboten. (GNU All-Permissive-Lizenz)

Statistische Daten

  • Erstellt am 2009-09-19, aktualisiert am 2011-08-29.
  • Erstmals in ARLog: Amateurfunk-Logbuch verwendet.
  • Ca. 200 Codezeilen, geschätzte Ent­wick­lungs­kos­ten: 200 - 800 €