Evento ContentControlBase.Validating

Artigo
05/21/2013

Ocorre quando o conteúdo do controle de conteúdo são validados.

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

Sintaxe

'Declaração
Event Validating As CancelEventHandler

event CancelEventHandler Validating

Comentários

O evento de Validating é gerado quando o controle perde o foco.Manipular o evento de Validating para determinar se o texto no controle de conteúdo é válido, de acordo com os critérios que você escolher.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).Se o conteúdo são inválidos, você pode cancelar o evento e retornar o foco para o controle definindo a propriedade de Cancel de parâmetro de CancelEventArgs manipulador de eventos a true.O efeito é possível que o usuário não pode deixar o controle até que o texto seja válido.

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

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 Validating e de Validated .Depois que o usuário final altera o texto no controle de conteúdo, o manipulador de eventos para o evento de Validating usa uma expressão regular para verificar que o texto não contém números inteiros.

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