ContentControlBase.Validated Событие (2007 System)

Статья
11/16/2008

Обновлен: Ноябрь 2007

Происходит после успешной проверки элемента управления содержимым.

Пространство имен: Microsoft.Office.Tools.Word
Сборка: Microsoft.Office.Tools.Word.v9.0 (в Microsoft.Office.Tools.Word.v9.0.dll)

Синтаксис

'Декларация
Public Event Validated As EventHandler
'Применение
Dim instance As ContentControlBase
Dim handler As EventHandler

AddHandler instance.Validated, handler

public event EventHandler Validated

Заметки

Обработчик событий Validated используется для выполнения кода после успешной проверки элемента управления содержимым.

Чтобы проверить элемент управления содержимым, создайте обработчик событий Validating. При проверке элемента управления содержимым гарантируется, что текст в элементе управления соответствует определенным условиям. Например, при использовании элемента управления содержимым с номером телефона можно проверить, что элемент управления содержит только допустимые знаки (цифры, скобки, дефисы).

Дополнительные сведения об обработке событий см. в разделе Прием событий.

Примеры

В приведенном ниже примере кода демонстрируются обработчики событий Validated и Validating. После проверки значения элемента управления содержимым обработчик событий Validated отображает окно сообщения для конечного пользователя.

В данном примере предполагается, что в документе содержится элемент управления PlainTextContentControl с именем plainTextContentControl1. Чтобы воспользоваться этим кодом, вставьте его в проекте в класс ThisDocument. В C# также необходимо присоединить обработчики событий к событиям Validated и Validating элемента управления plainTextContentControl1.

В этом примере демонстрируется настройка уровня документа.

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

Разрешения

Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.

См. также

Ссылки

ContentControlBase Класс

ContentControlBase - члены

Microsoft.Office.Tools.Word - пространство имен

Поделиться через