TipNotify クラス

検証が失敗したときに対象のCellにツールチップを表示できる特別なCellValidateActionを表します。

構文

Visual Basic (宣言)
C#

Public Class TipNotify 
   Inherits CellValidateAction
   Implements INamedObject

public class TipNotify : CellValidateAction, INamedObject

解説

ToolTipTextプロパティの値がnull 参照 (Visual Basicでは Nothing)またはString.Emptyの場合、ツールチップのテキストにはValidateContext.ValidateInfoが使用されます。

使用例

次のサンプルコードは、RequiredTypeValidatorを使用して、元の値のTypeがSystem.Decimalかどうかを検証します。入力モードに入って何らかの値を入力してから、［Esc］を押して編集をキャンセルすると、元の値が"I'm string type"であるため（これは10進数値ではありません）、検証が失敗してバルーンチップがポップアップします。このサンプルコードは、CellValidatorに示されている詳細なコード例の一部を抜粋したものです。

C#
Visual Basic

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

    RequiredTypeValidator requiredTypeValidator = new RequiredTypeValidator();
    requiredTypeValidator.RequiredType = typeof(decimal);

    TipNotify tipNotify = new TipNotify();
    tipNotify.ToolTipIcon = ToolTipIcon.Warning;
    tipNotify.ToolTipSpan = 6000;
    tipNotify.ToolTipTitle = "Requird Type Error";
    tipNotify.ToolTipText = "The original value is not Decimal type";
    //When you escape edit mode, the acion will be done(press ESC key commonly)
    tipNotify.DoActionReason = ValidateReasons.CancelEdit;
    requiredTypeValidator.Actions.Add(tipNotify);

    //When cancel edit, this value will be validated.
    template.Row.Cells[0].Value = "I'm string type";
    template.Row.Cells[0].Validators.Add(requiredTypeValidator);

    this.gcMultiRow1.Template = template;
    label.Text = "The RequiredTypeValidator's RequiredType is decimal type,by default, the cell's value is 'I'm string type', if you enter edit mode and input any value, then press ESC to escape edit mode to trigger validation(DoActionReason is CancelEdit), the old default value will be validated, it is not a Decimal type value, so validation failed.";
}

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

    Dim requiredTypeValidator As New RequiredTypeValidator()
    requiredTypeValidator.RequiredType = GetType(Decimal)

    Dim tipNotify As New TipNotify()
    tipNotify.ToolTipIcon = ToolTipIcon.Warning
    tipNotify.ToolTipSpan = 6000
    tipNotify.ToolTipTitle = "Requird Type Error"
    tipNotify.ToolTipText = "The original value is not Decimal type"
    'When you escape edit mode, the acion will be done(press ESC key commonly)
    tipNotify.DoActionReason = ValidateReasons.CancelEdit
    requiredTypeValidator.Actions.Add(tipNotify)

    'When cancel edit, this value will be validated.
    template.Row.Cells(0).Value = "I'm string type"
    template.Row.Cells(0).Validators.Add(requiredTypeValidator)

    Me.gcMultiRow1.Template = template
    label.Text = "The RequiredTypeValidator's RequiredType is decimal type,by default, the cell's value is 'I'm string type', if you enter edit mode and input any value, then press ESC to escape edit mode to trigger validation(DoActionReason is CancelEdit), the old default value will be validated, it is not a Decimal type value, so validation failed."
End Sub

継承階層

System.Object
GrapeCity.Win.MultiRow.CellValidateAction
GrapeCity.Win.MultiRow.TipNotify

参照

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