RowErrorTextNeeded Event

Occurs when a row's error text is needed.

Syntax

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

<SRCategoryAttribute("Data")>
<SRDescriptionAttribute("Occurs when a row's error text is needed. ")>
Public Event RowErrorTextNeeded As EventHandler(Of RowErrorTextNeededEventArgs)

Dim instance As GcMultiRow
Dim handler As EventHandler(Of RowErrorTextNeededEventArgs)
 
AddHandler instance.RowErrorTextNeeded, handler

[SRCategory("Data")]
[SRDescription("Occurs when a row's error text is needed. ")]
public event EventHandler<RowErrorTextNeededEventArgs> RowErrorTextNeeded

Event Data

The event handler receives an argument of type RowErrorTextNeededEventArgs containing data related to this event. The following RowErrorTextNeededEventArgs properties provide information specific to this event.

Property	Description
ErrorText	Gets or sets a string that describes the error for the current Row.
RowIndex	Gets the Row index.

Remarks

The RowErrorTextNeeded event occurs only when the DataSource property of the GcMultiRow control is set or its VirtualMode property is true. Handling the RowErrorTextNeeded event is useful when the user wants to determine the error for a row depending on its state and the values it contains.
When the user handles the RowErrorTextNeeded event and specifies error text in the handler, an error glyph appears in the row header cells unless the ShowRowErrors or RowHeaderCell.ShowRowError property is set to false. When the user moves the mouse pointer over the error glyph, the error text appears in a ToolTip.
The RowErrorTextNeeded event also occurs whenever the value of the Row.ErrorText property is retrieved.
The user can use the RowErrorTextNeededEventArgs.RowIndex property to determine the state of a row or the values it contains, and use this information to change or modify the RowErrorTextNeededEventArgs.ErrorText property. This property is initialized with the value of the row ErrorText property, which the event value overrides.

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

GcMultiRow Class
GcMultiRow Members