Evento ContentControlBase.Validated

Artigo
05/21/2013

Ocorre quando o controle de conteúdo é validado com êxito.

Namespace: Microsoft.Office.Tools.Word
Assembly: Microsoft.Office.Tools.Word (em Microsoft.Office.Tools.Word.dll)

Sintaxe

'Declaração
Event Validated As EventHandler

event EventHandler Validated

Comentários

Manipular o evento de Validated para executar o código após o controle de conteúdo foi validado com êxito.

Para validar o controle de conteúdo, manipule o evento de Validating .Quando você valide um controle de conteúdo, certifique-se que o texto no controle estiver em comformidade determinadas condições.Por exemplo, se você tiver um controle de conteúdo que contém um número de telefone, você pode verificar que contém somente os caracteres apropriada (números, parênteses, hifens).

Para obter mais informações sobre manipulação de eventos, consulte Consumindo eventos.

Exemplos

O exemplo de código a seguir demonstra manipuladores de eventos para os eventos de Validated e de Validating .Depois que o valor do controle de conteúdo é validado, o manipulador de eventos para o evento de Validated exibe uma caixa de mensagem para o usuário final.

Este exemplo assume que o documento contém PlainTextContentControl chamado plainTextContentControl1.Para usar este código, cole na classe de ThisDocument em seu projeto.Para C#, você também deve anexar manipuladores de eventos a eventos de Validated e de Validating de plainTextContentControl1.

Este exemplo é para uma personalização da nível.

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.");
}

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiáveis.

Consulte também

Referência

ContentControlBase Interface

Namespace Microsoft.Office.Tools.Word

Compartilhar via