Partager via


ContentControlBase.Validated, événement (System 2007)

Mise à jour : novembre 2007

Se produit lorsque le contrôle de contenu a été validé.

Espace de noms :  Microsoft.Office.Tools.Word
Assembly :  Microsoft.Office.Tools.Word.v9.0 (dans Microsoft.Office.Tools.Word.v9.0.dll)

Syntaxe

Public Event Validated As EventHandler

Dim instance As ContentControlBase
Dim handler As EventHandler

AddHandler instance.Validated, handler
public event EventHandler Validated

Notes

Gérez l'événement Validated pour exécuter le code après la validation du contrôle de contenu.

Pour valider le contrôle de contenu, gérez l'événement Validating. Lorsque vous validez un contrôle de contenu, vous vous assurez que le texte dans le contrôle répond à certaines conditions. Par exemple, si vous disposez d'un contrôle de contenu qui contient un numéro de téléphone, vous pouvez vérifier qu'il contient uniquement les caractères appropriés (nombres, parenthèses, traits d'union).

Pour plus d'informations sur la gestion des événements, consultez Consommation d'événements.

Exemples

L'exemple de code suivant illustre les gestionnaires des événements Validated et Validating. Une fois la valeur du contrôle de contenu validée, le gestionnaire d'événements de l'événement Validated affiche un message destiné à l'utilisateur final.

Cet exemple suppose que le document contient un PlainTextContentControl nommé plainTextContentControl1. Pour utiliser ce code, collez-le dans la classe ThisDocument de votre projet. En C#, vous devez également attacher les gestionnaires d'événements aux événements Validated et Validating de plainTextContentControl1.

Cet exemple illustre une personnalisation au niveau du document.

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

Autorisations

Voir aussi

Référence

ContentControlBase, classe

Membres ContentControlBase

Microsoft.Office.Tools.Word, espace de noms