ContentControlBase.Validated イベント (2007 System)
更新 : 2007 年 11 月
コンテンツ コントロールの検証が正常に完了したときに発生します。
名前空間 : 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 イベントのイベント ハンドラはエンド ユーザーにメッセージ ボックスを表示します。
この例では、文書に plainTextContentControl1 という名前の PlainTextContentControl が含まれることを前提としています。このコードを使用するには、プロジェクトの ThisDocument クラスにコードを貼り付けます。C# では、さらにイベント ハンドラを plainTextContentControl1 の Validated イベントおよび Validating イベントに結び付ける必要があります。
この例は、ドキュメント レベルのカスタマイズ用に作成されています。
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.");
}
アクセス許可
- 直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「部分信頼コードからのライブラリの使用」を参照してください。