OpenPetra
Free Administration Software for Non-Profits
Ict.Common.Verification.TScreenVerificationResult Class Reference

A TScreenVerificationResult object stores information about failed data verification in a Form or UserControl on the Client side. It is made to be stored in the TVerificationResultCollection. More...

Inheritance diagram for Ict.Common.Verification.TScreenVerificationResult:
Ict.Common.Verification.TVerificationResult Ict.Common.Verification.IResultInterface Ict.Common.Verification.IResultInterface

Public Member Functions

 TScreenVerificationResult (object AResultContext, DataColumn AResultColumn, String AResultText, String AResultCode, Object AResultControl, System.Guid ADataValidationRunID=new System.Guid())
 constructor More...
 
 TScreenVerificationResult (object AResultContext, DataColumn AResultColumn, String AResultText, Object AResultControl, TResultSeverity AResultSeverity, System.Guid ADataValidationRunID=new System.Guid())
 constructor More...
 
 TScreenVerificationResult (object AResultContext, DataColumn AResultColumn, String AResultText, String AResultCode, TResultSeverity AResultSeverity, System.Guid ADataValidationRunID=new System.Guid())
 Constructor More...
 
 TScreenVerificationResult (object AResultContext, DataColumn AResultColumn, String AResultText, String AResultCaption, String AResultCode, TResultSeverity AResultSeverity, System.Guid ADataValidationRunID=new System.Guid())
 Constructor More...
 
 TScreenVerificationResult (TVerificationResult AVerificationResult, DataColumn AResultColumn, System.Guid ADataValidationRunID=new System.Guid())
 Constructor More...
 
 TScreenVerificationResult (object AResultContext, DataColumn AResultColumn, String AResultText, TResultSeverity AResultSeverity, System.Guid ADataValidationRunID=new System.Guid())
 Constructor More...
 
void OverrideResultContext (object ANewResultContext)
 Overrides the ResultContext that the TVerificationResult was originally populated with. More...
 
void OverrideResultText (string ANewResultText)
 Overrides the ResultText that the TVerificationResult was originally populated with. More...
 
void OverrideResultTextCaption (string ANewResultTextCaption)
 Overrides the ResultTextCaption that the TVerificationResult was originally populated with. More...
 

Protected Attributes

object FResultContext = String.Empty
 DB Field or other context that describes where the data verification failed (use '[ODBC ...]' instead to signal a database error (such as a failed call to a stored procedure) More...
 
String FResultText = String.Empty
 Verification failure explanation More...
 
String FResultTextCaption = String.Empty
 Verification failure caption More...
 
String FResultCode = String.Empty
 Error code if verification failure More...
 
TResultSeverity FResultSeverity
 Signals whether the verification failure prevented saving of data (critical) or the verification result is only for information purposes (noncritical). More...
 
bool FControlValueUndoRequested = false
 Is true (or set to true) if the data validation code requests that the validated Control's value is undone. This is only useful for TScreenVerificationResults but needs to be declared in this Class to make the handling easier. More...
 
bool FSuppressValidationToolTip = false
 Is true (or set to true) if the data validation code requests that the validation ToolTip should not be shown on the validated Control. This is only useful for TScreenVerificationResults but needs to be declared in this Class to make the handling easier. More...
 
System.Guid FDataValidationRunID
 Data Validation Run ID. More...
 

Properties

DataColumn ResultColumn [get]
 the DataColumn of the verification failure More...
 
object ResultContext [get]
 Context of the Verification Result (where the Verification Result originated from). More...
 
String ResultText [get]
 Text of the Verification Result. More...
 
String ResultTextCaption [get]
 Caption of the Verification Result (e.g. for use in MessageBox Titles). More...
 
String ResultCode [get, set]
 ResultCode of the Verification Result. More...
 
TResultSeverity ResultSeverity [get]
 Severity of the Verification Result. More...
 
bool ControlValueUndoRequested [get, set]
 Is true (or set to true) if the data validation code requests that the validated Control's value is undone. More...
 
bool SuppressValidationToolTip [get, set]
 Is true (or set to true) if the data validation code requests that the validation ToolTip should not be shown on the validated Control. More...
 
System.Guid DataValidationRunID [get, set]
 Data Validation Run ID. More...
 

Detailed Description

A TScreenVerificationResult object stores information about failed data verification in a Form or UserControl on the Client side. It is made to be stored in the TVerificationResultCollection.

Constructor & Destructor Documentation

◆ TScreenVerificationResult() [1/6]

Ict.Common.Verification.TScreenVerificationResult.TScreenVerificationResult ( object  AResultContext,
DataColumn  AResultColumn,
String  AResultText,
String  AResultCode,
Object  AResultControl,
System.Guid  ADataValidationRunID = new System.Guid() 
)
inline

constructor

Parameters
AResultContextcontext of verification
AResultColumnwhich column failed
AResultTextdescription and error message for the user
AResultControlfor compatibility reasons, just pass null
AResultCodeerror code to identify the error message
ADataValidationRunIDA Data Validation Run ID that this instance should be associated with. Default: a new System.Guid instance.

◆ TScreenVerificationResult() [2/6]

Ict.Common.Verification.TScreenVerificationResult.TScreenVerificationResult ( object  AResultContext,
DataColumn  AResultColumn,
String  AResultText,
Object  AResultControl,
TResultSeverity  AResultSeverity,
System.Guid  ADataValidationRunID = new System.Guid() 
)
inline

constructor

Parameters
AResultContextcontext of verification
AResultColumnwhich column failed
AResultTextdescription and error message for the user
AResultControlfor compatibility reasons, just pass null
AResultSeverityis this serious, or just a warning
ADataValidationRunIDA Data Validation Run ID that this instance should be associated with. Default: a new System.Guid instance.

◆ TScreenVerificationResult() [3/6]

Ict.Common.Verification.TScreenVerificationResult.TScreenVerificationResult ( object  AResultContext,
DataColumn  AResultColumn,
String  AResultText,
String  AResultCode,
TResultSeverity  AResultSeverity,
System.Guid  ADataValidationRunID = new System.Guid() 
)
inline

Constructor

Parameters
AResultContextcontext of verification
AResultColumnwhich column failed
AResultTextdescription and error message for the user
AResultCodeerror code to identify the error message
AResultSeverityis this serious, or just a warning
ADataValidationRunIDA Data Validation Run ID that this instance should be associated with. Default: a new System.Guid instance.

◆ TScreenVerificationResult() [4/6]

Ict.Common.Verification.TScreenVerificationResult.TScreenVerificationResult ( object  AResultContext,
DataColumn  AResultColumn,
String  AResultText,
String  AResultCaption,
String  AResultCode,
TResultSeverity  AResultSeverity,
System.Guid  ADataValidationRunID = new System.Guid() 
)
inline

Constructor

Parameters
AResultContextcontext of verification
AResultColumnwhich column failed
AResultTextdescription and error message for the user
AResultCaptioncaption for error message box
AResultCodeerror code to identify the error message
AResultSeverityis this serious, or just a warning
ADataValidationRunIDA Data Validation Run ID that this instance should be associated with. Default: a new System.Guid instance.

◆ TScreenVerificationResult() [5/6]

Ict.Common.Verification.TScreenVerificationResult.TScreenVerificationResult ( TVerificationResult  AVerificationResult,
DataColumn  AResultColumn,
System.Guid  ADataValidationRunID = new System.Guid() 
)
inline

Constructor

Parameters
AVerificationResultTVerificationResult which contains the basic data to which the AResultColumn is getting added.
AResultColumnwhich column failed
ADataValidationRunIDA Data Validation Run ID that this instance should be associated with. Default: a new System.Guid instance.

◆ TScreenVerificationResult() [6/6]

Ict.Common.Verification.TScreenVerificationResult.TScreenVerificationResult ( object  AResultContext,
DataColumn  AResultColumn,
String  AResultText,
TResultSeverity  AResultSeverity,
System.Guid  ADataValidationRunID = new System.Guid() 
)
inline

Constructor

Parameters
AResultContextcontext of verification
AResultColumnwhich column failed
AResultTextdescription and error message for the user
AResultSeverityis this serious, or just a warning
ADataValidationRunIDA Data Validation Run ID that this instance should be associated with. Default: a new System.Guid instance.

Member Function Documentation

◆ OverrideResultContext()

void Ict.Common.Verification.TVerificationResult.OverrideResultContext ( object  ANewResultContext)
inlineinherited

Overrides the ResultContext that the TVerificationResult was originally populated with.

Parameters
ANewResultContextNew ResultText.

◆ OverrideResultText()

void Ict.Common.Verification.TVerificationResult.OverrideResultText ( string  ANewResultText)
inlineinherited

Overrides the ResultText that the TVerificationResult was originally populated with.

Parameters
ANewResultTextNew ResultText.

◆ OverrideResultTextCaption()

void Ict.Common.Verification.TVerificationResult.OverrideResultTextCaption ( string  ANewResultTextCaption)
inlineinherited

Overrides the ResultTextCaption that the TVerificationResult was originally populated with.

Parameters
ANewResultTextCaptionNew ResultTextCaption.

Member Data Documentation

◆ FControlValueUndoRequested

bool Ict.Common.Verification.TVerificationResult.FControlValueUndoRequested = false
protectedinherited

Is true (or set to true) if the data validation code requests that the validated Control's value is undone. This is only useful for TScreenVerificationResults but needs to be declared in this Class to make the handling easier.

◆ FDataValidationRunID

System.Guid Ict.Common.Verification.TVerificationResult.FDataValidationRunID
protectedinherited

Data Validation Run ID.

◆ FResultCode

String Ict.Common.Verification.TVerificationResult.FResultCode = String.Empty
protectedinherited

Error code if verification failure

◆ FResultContext

object Ict.Common.Verification.TVerificationResult.FResultContext = String.Empty
protectedinherited

DB Field or other context that describes where the data verification failed (use '[ODBC ...]' instead to signal a database error (such as a failed call to a stored procedure)

◆ FResultSeverity

TResultSeverity Ict.Common.Verification.TVerificationResult.FResultSeverity
protectedinherited

Signals whether the verification failure prevented saving of data (critical) or the verification result is only for information purposes (noncritical).

◆ FResultText

String Ict.Common.Verification.TVerificationResult.FResultText = String.Empty
protectedinherited

Verification failure explanation

◆ FResultTextCaption

String Ict.Common.Verification.TVerificationResult.FResultTextCaption = String.Empty
protectedinherited

Verification failure caption

◆ FSuppressValidationToolTip

bool Ict.Common.Verification.TVerificationResult.FSuppressValidationToolTip = false
protectedinherited

Is true (or set to true) if the data validation code requests that the validation ToolTip should not be shown on the validated Control. This is only useful for TScreenVerificationResults but needs to be declared in this Class to make the handling easier.

Property Documentation

◆ ControlValueUndoRequested

bool Ict.Common.Verification.TVerificationResult.ControlValueUndoRequested
getsetinherited

Is true (or set to true) if the data validation code requests that the validated Control's value is undone.

◆ DataValidationRunID

System.Guid Ict.Common.Verification.TVerificationResult.DataValidationRunID
getsetinherited

Data Validation Run ID.

◆ ResultCode

String Ict.Common.Verification.TVerificationResult.ResultCode
getsetinherited

ResultCode of the Verification Result.

Implements Ict.Common.Verification.IResultInterface.

◆ ResultColumn

DataColumn Ict.Common.Verification.TScreenVerificationResult.ResultColumn
get

the DataColumn of the verification failure

Returns

◆ ResultContext

object Ict.Common.Verification.TVerificationResult.ResultContext
getinherited

Context of the Verification Result (where the Verification Result originated from).

This Property cannot be written to in order to avoid accidental overwriting. However, by calling the Method OverrideResultContext the ResultContext can be modified.

Implements Ict.Common.Verification.IResultInterface.

◆ ResultSeverity

TResultSeverity Ict.Common.Verification.TVerificationResult.ResultSeverity
getinherited

Severity of the Verification Result.

Implements Ict.Common.Verification.IResultInterface.

◆ ResultText

String Ict.Common.Verification.TVerificationResult.ResultText
getinherited

Text of the Verification Result.

This Property cannot be written to in order to avoid accidental overwriting. However, by calling the Method OverrideResultText the ResultText can be modified.

Implements Ict.Common.Verification.IResultInterface.

◆ ResultTextCaption

String Ict.Common.Verification.TVerificationResult.ResultTextCaption
getinherited

Caption of the Verification Result (e.g. for use in MessageBox Titles).

This Property cannot be written to in order to avoid accidental overwriting. However, by calling the Method OverrideResultTextCaption the ResultTextCaption can be modified.

Implements Ict.Common.Verification.IResultInterface.

◆ SuppressValidationToolTip

bool Ict.Common.Verification.TVerificationResult.SuppressValidationToolTip
getsetinherited

Is true (or set to true) if the data validation code requests that the validation ToolTip should not be shown on the validated Control.


The documentation for this class was generated from the following file: