Evento ContentControlBase.Validated

Artigo
08/01/2011

Ocorre quando o controle de conteúdo foi 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

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

Para validar o controle de conteúdo, lidar com o Validating de evento. Quando você valida um controle de conteúdo, certifique-se de que o texto no controle atenderem a 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 ele contém apenas os caracteres apropriados (números, parênteses, hífens).

Para obter mais informações sobre tratamento eventos, consulte Consumindo Eventos.

Exemplos

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

Este exemplo assume que o documento contém um PlainTextContentControl chamado plainTextContentControl1. Para usar esse código, colá-lo para o ThisDocument classe no projeto. Para C#, você também deve anexar os manipuladores de eventos para o Validated e Validating eventos de plainTextContentControl1.

Este exemplo é para uma personalização em nível de documento.

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

Partilhar via