LineNotify クラス

検証が失敗したときに対象のCellに下線を表示できる特別なAppearanceActionBaseを表します。

構文

Visual Basic (宣言)
C#

Public Class LineNotify 
   Inherits AppearanceActionBase
   Implements INamedObject

public class LineNotify : AppearanceActionBase, INamedObject

解説

このアクションが実行された場合は、ShowWaveLineInEditingStatusの設定にかかわらず、波線を表示できます。

波線は編集状態のときにも表示できます。

使用例

次のサンプルコードは、RangeValidatorを使用して、コミットされた値がRangeValidator.MinValueとRangeValidator.MaxValueの間にあるかどうかを検証します。入力モードに入って「49」（範囲外）と入力し、［Enter］キーを押して編集を終了すると、検証が失敗したことを示す赤の下線が表示されます。「55」（範囲内）と入力して［Enter］キーを押した場合は、検証が成功し、下線は表示されません。このサンプルコードは、CellValidatorに示されている詳細なコード例の一部を抜粋したものです。

C#
Visual Basic

void setRangeValidator_Click(object sender, EventArgs e)
{
    Template template = Template.CreateGridTemplate(1);

    //Create one RangeValidator to vaidate whether the committed value is between one range.
    RangeValidator rangValidator = new RangeValidator();
    //You should set the RequiredType first, then set other Properties.
    rangValidator.RequiredType = typeof(int);
    rangValidator.MinValue = 5;
    rangValidator.MaxValue = 10;
    rangValidator.NullIsValid = false;

    LineNotify lineNotifyAction = new LineNotify();
    //When you ends edit mode, the action will be done.(press Enter key commonly)
    lineNotifyAction.DoActionReason = ValidateReasons.EndEdit;
    lineNotifyAction.LineColor = Color.Red;

    rangValidator.Actions.Add(lineNotifyAction);

    template.Row.Cells[0].Validators.Add(rangValidator);

    this.gcMultiRow1.Template = template;
    label.Text = "The RangeValidator's MinValue is 5, MaxValue is 10, input 4(not between the range) in one Cell, press Enter key to trigger validation(DoActionReason is EndEdit), one red under line will be shown.";
}

Private Sub setRangeValidator_Click(ByVal sender As Object, ByVal e As EventArgs) Handles setRangeValidator.Click
    Dim template As Template = template.CreateGridTemplate(1)

    'Create one RangeValidator to vaidate whether the committed value is between one range.
    Dim rangValidator As New RangeValidator()
    'You should set the RequiredType first, then set other Properties.
    rangValidator.RequiredType = GetType(Integer)
    rangValidator.MinValue = 5
    rangValidator.MaxValue = 10
    rangValidator.NullIsValid = False

    Dim lineNotifyAction As New LineNotify()
    'When you ends edit mode, the action will be done.(press Enter key commonly)
    lineNotifyAction.DoActionReason = ValidateReasons.EndEdit
    lineNotifyAction.LineColor = Color.Red

    rangValidator.Actions.Add(lineNotifyAction)

    template.Row.Cells(0).Validators.Add(rangValidator)

    Me.gcMultiRow1.Template = template
    label.Text = "The RangeValidator's MinValue is 5, MaxValue is 10, input 4(not between the range) in one Cell, press Enter key to trigger validation(DoActionReason is EndEdit), one red under line will be shown."
End Sub

継承階層

System.Object
   GrapeCity.Win.MultiRow.CellValidateAction
      GrapeCity.Win.MultiRow.AppearanceActionBase
         GrapeCity.Win.MultiRow.LineNotify

参照

LineNotify メンバ
 GrapeCity.Win.MultiRow 名前空間
 CellValidateAction クラス