TipNotify Class

Represents a special CellValidateAction that shows a tool tip for the validating Cell when validation fails.

Syntax

Visual Basic (Declaration)
Visual Basic (Usage)
C#

<ToolboxBitmapAttribute()>
<DefaultPropertyAttribute("ToolTipIcon")>
Public Class TipNotify 
   Inherits CellValidateAction
   Implements INamedObject

Dim instance As TipNotify

[ToolboxBitmap()]
[DefaultProperty("ToolTipIcon")]
public class TipNotify : CellValidateAction, INamedObject

Remarks

If the ToolTipText property value is a null reference (Nothing in Visual Basic) or String.Empty, the tool tip text uses ValidateContext.ValidateInfo.

Example

The following code example uses the RequiredTypeValidator to validate whether the original value's type is System.Decimal. A balloon tip is displayed to show the validation failed. Enter edit mode, type a value, and press the Esc key to cancel editing to see this. The validation fails because the original value is "I'm string type" and is not a decimal value. This example is part of a larger example available for the CellValidator class.

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 is done (press ESC key)
            tipNotify.DoActionReason = ValidateReasons.CancelEdit;
            requiredTypeValidator.Actions.Add(tipNotify);

            //When cancel edit, this value is validated.
            template.Row.Cells[0].Value = "I'm a 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 a 
string type', if you enter edit mode and input a value, then press ESC to escape edit mode to trigger validation 
(DoActionReason is CancelEdit), the old default value is validated, it is not a Decimal type value, so validation fails.";
        }

VB.NET

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 action is done (press ESC key)
        tipNotify.DoActionReason = ValidateReasons.CancelEdit
        requiredTypeValidator.Actions.Add(tipNotify)

        'When cancel edit, this value is 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 a value, then press ESC to escape edit mode to trigger validation 
(DoActionReason is CancelEdit), the old default value is validated, it is not a Decimal type value, so validation fails."
    End Sub

Inheritance Hierarchy

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

Requirements

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

Reference

TipNotify Members
GrapeCity.Win.MultiRow Namespace
CellValidateAction Class