バージョン

NotificationSettings クラス

エンドユーザーに検証の失敗を通知する方法を決定するプロパティを公開します。
シンタックス
'宣言
 
Public Class NotificationSettings 
   Inherits Infragistics.Shared.SubObjectBase
public class NotificationSettings : Infragistics.Shared.SubObjectBase
解説

NotificationSettings クラスは、UltraValidator コンポーネントによって拡張された通知機能をカプセル化します。検証エラーが発生した時にエンドユーザーに通知する方法に関係するほとんどの設定はこのクラスによって公開されます。Action プロパティで定義される通知のタイプで、NotificationAction タイプ。エンドユーザーに通知する各方法を定義する列挙体です。以下の表は、その動作の高レベルの説明とこのクラスのその他のプロパティの使用方法とともに各定数を列挙します。

この設定によって、コントロール/埋め込み要素の右上隅をポイントする吹き出しとともに balloon tipは表示されることになります。Captionプロパティの値がバルーン チップのタイトルに表示され、Textプロパティが表示されるテキストを定義し、Imageプロパティの値が表示される画像を定義します。

注: BalloonTip は、関連付けられたコントロールまたは埋め込みエディターが入力フォーカスを持つ時に限り表示されます。コントロール/エディターがフォーカスを失うによって検証がトリガーされた場合は (ValidationTriggerを参照ください) 、RetainFocusOnErrorプロパティが true に設定されない場合は、バルーンチップが表示されません(プロパティのデフォルト値は false です)。 前述のすべての設定により、Soundプロパティが明示的に設定される場合、視覚的な通知の前にサウンドが再生されます。SoundOnly 設定では、視覚的な通知は一切表示されず、このサウンドが再生されます。Actionプロパティが SoundOnly に設定され、Sound プロパティが明示的に設定されていない場合、Beepプロパティが使用されてシステム定義のサウンドを生成します。 名前が意味するように、UltraValidator によって通知は発行されません。ValidationErrorイベントは通知設定とは無関係に発生します。None 設定を使用して通知を完全に抑制する、またはダイアログなどのカスタマイズされた通知を表示することができます。

定数 説明
画像

スタンドアロン コントロールでは、この設定は Windows Forms ErrorProvider コンポーネントによって提供される機能と非常に似ています。ただし、ErrorProvider がアイコンのみをサポートする場合、UltraValidator は任意の画像の表示をサポートします。表示される画像は Image プロパティによって定義されます。明示的な設定がない場合、白の「X」がついた赤い丸が表示されます。表示される画像が ErrorImageSize プロパティによって決定されるサイズ。コントロールとエラー画像間の水平方向のスペースの量は、ErrorImagePadding プロパティによって決定されます。コントロールの境界に相対したエラー画像の配置は、ErrorImageAlignment プロパティによって決定されます。これらの画像の透明度は完全にサポートされます。デフォルトで、左下のピクセルの色は画像が表示される時にマスクされる色を決定します。透明な色として指定される色は ErrorImageTransparentColor プロパティを使用して明示的に指定できます。画像は一定の間隔で点滅するように設定できます。画像を点滅させるかどうかは ErrorImageTransparentColor プロパティによって決定され、点滅の間隔は ErrorImageBlinkRate プロパティによって決定されます。エンドユーザーがこの画像上にマウスをホバーすると、画像をポイントする吹き出しとともに balloon tip が表示されます。点滅が有効だった場合、カーソルがコントロール上に配置されたままの間は中断されます。Caption プロパティの値はバルーン チップのタイトルに表示され、Text プロパティの値は表示するテキストを定義します。画像をダブルクリックすると、関連付けられたコントロールが選択されます。

embeddable editors では、'Image' 設定はサポートされますが、スタンドアロン コントロールに対する動作と異なる動作を公開します。最も顕著なことですが、境界の外側と対象的に、画像は埋め込みエディターの UI element 内に表示されます。明示的な検証に対応して表示/非表示になるのと対照的に、検証基準に定義されたように現在の値が無効な時には常にこの画像が表示されます。
MessageBox この設定によって検証セッションが失敗した時に MessageBox が表示されることになります。Caption プロパティの値が MessageBox の MessageBox.Show メソッドの caption パラメーターに渡され、Text プロパティの値が text パラメーターに渡されます。buttons パラメーターは常に OK にハードコードされます。メッセージ ボックスは情報提供のみを目的として表示されるからです。icon パラメーターの値は UltraValidator の MessageBoxIcon プロパティによって定義されます。
BalloonTip
SoundOnly
None

通知設定は 2 つの異なるレベルでデザイン モードで指定できます。NotificationSettings プロパティによって返されるインスタンスがコントロールレベル プロパティとして拡張される ValidationSettings インスタンスに優先します。これらの設定は拡張されたコントロールのみに適用されます。NotificationSettings プロパティも UltraValidator コンポーネントによって公開されます。そのインスタンスでの設定は、そのコンポーネント インスタンスによって拡張された ValidationSettings インスタンスを使用するすべてのコントロールに適用されます。さらに、 ValidationErrorイベントのための event arguments クラスは NotificationSettings プロパティを公開します。このインスタンスには解決されたプロパティが含まれており、そのイベントのリスナーが通知動作を動的に修正可能であるようにすべてが設定可能です。

NotificationSettings クラスのプロパティは単一のコントロールまたは埋め込みエディターが検証される場合に限り適用可能です。つまり、検証がユーザー操作によってトリガーされる、または特定のコントロール参照を取得する Validate メソッド オーバー読み込みによって検証がトリガーされる時です。複数のコントロールの検証をサポートする Validate メソッド オーバー読み込みは MessageBox とエラー画像の両方またはいずれか一方を表示する能力を提供しますが、この動作はメソッド パラメーターによって決定され、NotificationSettings プロパティの値に関係がありません。

参照