MaskedTextBox.MaskInputRejected Událost

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

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;

member this.MaskInputRejected : System.Windows.Forms.MaskInputRejectedEventHandler 

Public Custom Event MaskInputRejected As MaskInputRejectedEventHandler 

Event Type

MaskInputRejectedEventHandler

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ý.

Viz také

• Text
• Mask
• MaskedTextProvider
• MaskInputRejectedEventArgs
• IsOverwriteMode
• BeepOnError