ContentControlBase.Validating – událost

Článek
05/14/2013

Vyvolá se v případě ověřuje obsah ovládacího prvku obsahu.

Obor názvů: Microsoft.Office.Tools.Word
Sestavení: Microsoft.Office.Tools.Word (v Microsoft.Office.Tools.Word.dll)

Syntaxe

'Deklarace
Event Validating As CancelEventHandler

event CancelEventHandler Validating

Poznámky

Validating Událost je aktivována, když ovládací prvek ztratí fokus.Zpracování Validating události, chcete-li zjistit, zda je text v ovládacím prvku obsahu platné podle zvoleného kritéria.Například pokud máte ovládací prvek obsahu, který obsahuje telefonní číslo, můžete ověřit, že obsahuje pouze požadované znaky (čísla, závorky, pomlčky).Pokud obsah není platná, můžete zrušit událost a vrátit fokus na ovládací prvek nastavením Cancel vlastnost CancelEventArgs parametru obslužné rutiny události pro true.Praktický význam je, že uživatel nelze ponechat ovládací prvek, dokud text není platný.

Chcete-li spustit kód, poté, co ovládací prvek obsahu byla úspěšně ověřen, zpracujte Validated události.

Další informace o zpracování událostí, naleznete v Náročné události.

Příklady

Následující příklad kódu ukazuje obslužných rutin událostí Validating a Validated události.Řízení poté, co koncový uživatel změní text v obsahu, obslužnou rutinu události Validating událostí používá regulární výraz, chcete-li ověřit, zda text neobsahuje celá čísla.

Tento příklad předpokládá, že dokument obsahuje PlainTextContentControl s názvem plainTextContentControl1.Chcete-li použít tento kód, vložte jej do ThisDocument tříd v projektu.Pro jazyk C#, je nutné připojit také obslužné rutiny událostí k Validated a Validating události z plainTextContentControl1.

V tomto příkladu je úroveň dokument přizpůsobení.

Private Sub plainTextContentControl1_Validating(ByVal sender As Object, _
    ByVal e As System.ComponentModel.CancelEventArgs) _
    Handles PlainTextContentControl1.Validating

    Dim control As Microsoft.Office.Tools.Word.PlainTextContentControl = _
        TryCast(sender, Microsoft.Office.Tools.Word.PlainTextContentControl)

    If control IsNot Nothing Then
        Dim regex As New System.Text.RegularExpressions.Regex("\d")
        If regex.IsMatch(control.Text) Then
            MessageBox.Show("Invalid name. Names cannot contain integers.")
            e.Cancel = True
        End If
    End If
End Sub

Private Sub plainTextContentControl1_Validated(ByVal sender As Object, ByVal e As System.EventArgs) _
    Handles PlainTextContentControl1.Validated

    MessageBox.Show("The name is valid.")
End Sub

void plainTextContentControl1_Validating(object sender, System.ComponentModel.CancelEventArgs e)
{
    Microsoft.Office.Tools.Word.PlainTextContentControl control =
        sender as Microsoft.Office.Tools.Word.PlainTextContentControl;

    if (control != null)
    {
        System.Text.RegularExpressions.Regex regex = new System.Text.RegularExpressions.Regex(@"\d");
        if (regex.IsMatch(control.Text))
        {
            MessageBox.Show("Invalid name. Names cannot contain integers.");
            e.Cancel = true;
        }
    }
}

void plainTextContentControl1_Validated(object sender, EventArgs e)
{
    MessageBox.Show("The name is valid.");
}

Zabezpečení rozhraní .NET Framework

Plná důvěra přímému volajícímu. Částečně zabezpečený kód nemůže tento člen použít. Další informace naleznete v tématu Používání knihoven z částečně důvěryhodného kódu.

Viz také

Referenční dokumentace

ContentControlBase Rozhraní

Microsoft.Office.Tools.Word – obor názvů

Sdílet prostřednictvím