Evento ContentControlBase.Validating (sistema de 2007)

Artigo
08/25/2010

Ocorre quando o Sumário do controle de Sumário está sendo validado.

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

Sintaxe

Public Event Validating As CancelEventHandler

Dim instance As ContentControlBase
Dim handler As CancelEventHandler

AddHandler instance.Validating, handler

public event CancelEventHandler Validating

Comentários

The Validating evento é ocasionado quando o controle perde o foco. Manipular o Validating evento para determinar se o texto no controle de conteúdo é válido, de acordo com 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 ele contém apenas os caracteres apropriados (números, parênteses, hífens).Se o Sumário inválido, você cancelar o evento e retornar o foco para o controle definindo a Cancel propriedade das CancelEventArgs parâmetro do manipulador de eventos para true. O efeito prático é que o usuário não pode deixar o controle até que o texto seja válido.

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

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

Este exemplo assume que o documento contém um PlainTextContentControl chamada plainTextContentControl1. Para usar esse código, cole-o no ThisDocument classe em seu projeto. Para translation from VPE for Csharp, você também deve anexar o evento manipuladores à Validated e Validating s evento de plainTextContentControl1.

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

PrivateSub plainTextContentControl1_Validating(ByVal sender AsObject, _
    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 IsNotNothingThenDim regex AsNew System.Text.RegularExpressions.Regex("\d")
        If regex.IsMatch(control.Text) Then
            MessageBox.Show("Invalid name. Names cannot contain integers.")
            e.Cancel = TrueEndIfEndIfEndSubPrivateSub plainTextContentControl1_Validated(ByVal sender AsObject, ByVal e As System.EventArgs) _
    Handles PlainTextContentControl1.Validated

    MessageBox.Show("The name is valid.")
EndSub

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

Permissões

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ódigos parcialmente Confiável.

Consulte também

Referência

ContentControlBase Classe

Membros ContentControlBase

Namespace Microsoft.Office.Tools.Word

Compartilhar via