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ž vstup uživatele nebo přiřazený znak neodpovídá odpovídajícímu prvku formátu 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 členu. V 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 s laděním. Pokud chcete 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 k víceřádkovému TextBoxobjektu .
Pokud chcete spustit ukázkový kód, vložte ho do projektu, který obsahuje instanci typu MaskedTextBox s názvem MaskedTextBox1. Pak 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 pro MaskedTextBox třídu .
Událost MaskInputRejected nastane, když vstupní maska odmítne znak. Vstupní maska reprezentovaná Mask vlastností je interpretována zprostředkovatelem maskovaného textu přidruženého 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 elementu formátu. Uživatel například zadá abecední znak, pokud je vyžadována číslice. To je pravděpodobně nejčastější důvod, proč je tato událost vyvolána.
Uživatel se pokouší zadat nadbytečné znaky za konec masky, protože maska již byla vyplněna, nebo protože aktuální pozice kurzoru byla přesunuta na samotný 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 , přesune stávající znaky na nové pozice, kde neodpovídají svým prvkům formátu.Operace vyjmutí posune existující znaky doleva a jeden nebo více znaků neodpovídá jejich nově přidruženým prvkům formátu.
Bylo provedeno přiřazení vlastnosti Text a přiřazený řetězec způsobil jedno nebo více porušení masky.
Pokud byl k ovládacímu prvku přiřazen řetězec, který způsobuje MaskInputRejected výskyt, nezobrazí se v MaskedTextBoxsouboru žádná část řetězce.
Výchozí zpracování pro MaskInputRejected přehraje zvukový signál, pokud BeepOnError je vlastnost nastavená na truehodnotu . Tato událost se často zpracovává k implementaci 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ý.
