MaskedTextBox.MaskInputRejected Událost
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Nastane, když se vstup nebo přiřazený znak uživatele neshoduje s odpovídajícím formátovacím prvkem vstupní masky.
public:
event System::Windows::Forms::MaskInputRejectedEventHandler ^ MaskInputRejected;public event System.Windows.Forms.MaskInputRejectedEventHandler MaskInputRejected;public event System.Windows.Forms.MaskInputRejectedEventHandler? MaskInputRejected;member this.MaskInputRejected : System.Windows.Forms.MaskInputRejectedEventHandler Public Custom Event MaskInputRejected As MaskInputRejectedEventHandler Event Type
Příklady
Následující příklad kódu ukazuje použití tohoto člena. V tomto příkladu obslužná rutina události hlásí výskyt MaskInputRejected události. Tato sestava vám pomůže zjistit, kdy k události dojde, a může vám pomoct při ladění. Chcete-li hlásit více událostí nebo událostí, ke kterým dochází často, zvažte nahrazení MessageBox.ShowConsole.WriteLine nebo připojení zprávy do víceřádkového řetězce TextBox.
Pokud chcete spustit ukázkový kód, vložte ho do projektu, který obsahuje instanci typu MaskedTextBox s názvem MaskedTextBox1. Potom se ujistěte, že je obslužná rutina události přidružená k MaskInputRejected události.
private void MaskedTextBox1_MaskInputRejected(Object sender, MaskInputRejectedEventArgs e) {
System.Text.StringBuilder messageBoxCS = new System.Text.StringBuilder();
messageBoxCS.AppendFormat("{0} = {1}", "Position", e.Position );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "RejectionHint", e.RejectionHint );
messageBoxCS.AppendLine();
MessageBox.Show(messageBoxCS.ToString(), "MaskInputRejected Event" );
}
Private Sub MaskedTextBox1_MaskInputRejected(sender as Object, e as MaskInputRejectedEventArgs) _
Handles MaskedTextBox1.MaskInputRejected
Dim messageBoxVB as New System.Text.StringBuilder()
messageBoxVB.AppendFormat("{0} = {1}", "Position", e.Position)
messageBoxVB.AppendLine()
messageBoxVB.AppendFormat("{0} = {1}", "RejectionHint", e.RejectionHint)
messageBoxVB.AppendLine()
MessageBox.Show(messageBoxVB.ToString(),"MaskInputRejected Event")
End Sub
Poznámky
MaskInputRejected je výchozí událost třídy MaskedTextBox .
Událost MaskInputRejected nastane, když vstupní maska odmítne znak. Vstupní maska reprezentovaná Mask vlastností je interpretována maskovaným textovým zprostředkovatelem přidruženým k ovládacímu prvku prostřednictvím MaskedTextProvider vlastnosti. MaskInputRejected je vyvolána v následujících situacích:
Vstupní znak neodpovídá odpovídajícímu prvku formátu. Uživatel například zadá abecední znak, když se vyžaduje číslice. Toto je pravděpodobně nejčastější důvod, proč je tato událost vyvolána.
Uživatel se pokouší zadat nadbytečné znaky za koncem masky, a to buď proto, že maska již byla vyplněna, nebo aktuální pozice kurzoru byla přesunuta na konec zobrazeného řetězce vstupní masky.
Operace vložení buď vloží znak, který neodpovídá přidruženému prvku formátu, nebo pokud IsOverwriteMode je
falsevlastnost , posune existující znaky na nové pozice, kde neodpovídají prvkům formátu.Operace vyjmutí posune existující znaky doleva a jeden nebo více znaků neodpovídá nově přidruženým prvkům formátu.
Přiřazení bylo provedeno k Text vlastnosti a přiřazený řetězec způsobil jedno nebo více porušení masky.
Pokud byl řetězec přiřazen ovládacímu prvku, který způsobuje MaskInputRejected výskyt, nezobrazí se žádná část řetězce .MaskedTextBox
Výchozí zpracování MaskInputRejected pro přehrání zvuku pípnutí, pokud BeepOnError je vlastnost nastavena na true. Tato událost se často zpracovává za účelem implementace vlastního zpracování chyb, například k přechodu na další ovládací prvek uživatelského vstupu, pokud je maska plná, nebo k zobrazení vlastního dialogového okna chyby nebo popisu, pokud je vstupní znak neplatný.
