ig.excel.DataValidationRule
Dependencies
-
clone
- .clone( );
Creates a copy of this rule which can be applied to other worksheets.
-
errorMessageDescription
- .errorMessageDescription( );
- Return Type:
- string
- Return Type Description:
- The description to show the user or null to use a default error description.
Gets the description which appears in the dialog box when an invalid value is applied to a cell in Microsoft Excel.
Exceptions
Exception Description ig.ArgumentException Occurs when the specified value is longer than 225 characters. Remarks
This value is only used when DataValidationRule.showErrorMessageForInvalidValue is True.
Note: the title cannot be more than 225 characters.
See Also
-
errorMessageDescription
- .errorMessageDescription( value:string );
- Return Type:
- string
- Return Type Description:
- The description to show the user or null to use a default error description.
Sets the description which appears in the dialog box when an invalid value is applied to a cell in Microsoft Excel.
- value
- Type:string
Exceptions
Exception Description ig.ArgumentException Occurs when the specified value is longer than 225 characters. Remarks
This value is only used when DataValidationRule.showErrorMessageForInvalidValue is True.
Note: the title cannot be more than 225 characters.
See Also
-
errorMessageTitle
- .errorMessageTitle( );
- Return Type:
- string
- Return Type Description:
- The title to show the user or null to use a default error dialog title.
Gets the title which appears in the dialog box when an invalid value is applied to a cell in Microsoft Excel.
Exceptions
Exception Description ig.ArgumentException Occurs when the specified value is longer than 32 characters. Remarks
This value is only used when DataValidationRule.showErrorMessageForInvalidValue is True.
Note: the title cannot be more than 32 characters.
See Also
-
errorMessageTitle
- .errorMessageTitle( value:string );
- Return Type:
- string
- Return Type Description:
- The title to show the user or null to use a default error dialog title.
Sets the title which appears in the dialog box when an invalid value is applied to a cell in Microsoft Excel.
- value
- Type:string
Exceptions
Exception Description ig.ArgumentException Occurs when the specified value is longer than 32 characters. Remarks
This value is only used when DataValidationRule.showErrorMessageForInvalidValue is True.
Note: the title cannot be more than 32 characters.
See Also
-
errorStyle
- .errorStyle( );
Gets the value which indicates whether the value is allowed when it is invalid and which options are given to the user in the error dialog shown by Microsoft Excel.
Exceptions
Exception Description ig.excel.InvalidEnumArgumentException Occurs when the value is not a member of the DataValidationErrorStyle enumeration. Remarks
This value is only used when DataValidationRule.showErrorMessageForInvalidValue is True.
See Also
-
errorStyle
- .errorStyle( value:ig.excel.DataValidationErrorStyle );
Sets the value which indicates whether the value is allowed when it is invalid and which options are given to the user in the error dialog shown by Microsoft Excel.
- value
- Type:ig.excel.DataValidationErrorStyle
Exceptions
Exception Description ig.excel.InvalidEnumArgumentException Occurs when the value is not a member of the DataValidationErrorStyle enumeration. Remarks
This value is only used when DataValidationRule.showErrorMessageForInvalidValue is True.
See Also
-
inputMessageDescription
- .inputMessageDescription( );
- Return Type:
- string
- Return Type Description:
- The description to show the user in the tooltip.
Gets the description in the tooltip which appears when the user selects the cell in Microsoft Excel.
Exceptions
Exception Description ig.ArgumentException Occurs when the specified value is longer than 255 characters. Remarks
This value is only used when DataValidationRule.showInputMessage is True.
Note: the description cannot be more than 255 characters.
See Also
-
inputMessageDescription
- .inputMessageDescription( value:string );
- Return Type:
- string
- Return Type Description:
- The description to show the user in the tooltip.
Sets the description in the tooltip which appears when the user selects the cell in Microsoft Excel.
- value
- Type:string
Exceptions
Exception Description ig.ArgumentException Occurs when the specified value is longer than 255 characters. Remarks
This value is only used when DataValidationRule.showInputMessage is True.
Note: the description cannot be more than 255 characters.
See Also
-
inputMessageTitle
- .inputMessageTitle( );
- Return Type:
- string
- Return Type Description:
- The title to show the user in the tooltip.
Gets the title in the tooltip which appears when the user selects the cell in Microsoft Excel.
Exceptions
Exception Description ig.ArgumentException Occurs when the specified value is longer than 32 characters. Remarks
This value is only used when DataValidationRule.showInputMessage is True.
Note: the title cannot be more than 32 characters.
See Also
-
inputMessageTitle
- .inputMessageTitle( value:string );
- Return Type:
- string
- Return Type Description:
- The title to show the user in the tooltip.
Sets the title in the tooltip which appears when the user selects the cell in Microsoft Excel.
- value
- Type:string
Exceptions
Exception Description ig.ArgumentException Occurs when the specified value is longer than 32 characters. Remarks
This value is only used when DataValidationRule.showInputMessage is True.
Note: the title cannot be more than 32 characters.
See Also
-
showErrorMessageForInvalidValue
- .showErrorMessageForInvalidValue( );
- Return Type:
- boolean
- Return Type Description:
- True to show the error dialog for invalid cell data; False otherwise.
Gets the value which indicates whether the error dialog should appear in Microsoft Excel when invalid data is entered in the cell.
Remarks
When the value is False, invalid data can be entered into cells, but when the user chooses to subsequently circle invalid values in Microsoft Excel, the cell will be circled.
-
showErrorMessageForInvalidValue
- .showErrorMessageForInvalidValue( value:boolean );
- Return Type:
- boolean
- Return Type Description:
- True to show the error dialog for invalid cell data; False otherwise.
Sets the value which indicates whether the error dialog should appear in Microsoft Excel when invalid data is entered in the cell.
- value
- Type:boolean
Remarks
When the value is False, invalid data can be entered into cells, but when the user chooses to subsequently circle invalid values in Microsoft Excel, the cell will be circled.
-
showInputMessage
- .showInputMessage( );
Gets the value which indicates whether to show the user an input prompt tooltip when the user selects the cell in Microsoft Excel.
Remarks
The input prompt will only be shown if this value is True and the DataValidationRule.inputMessageDescription is not null.
-
showInputMessage
- .showInputMessage( value:boolean );
Sets the value which indicates whether to show the user an input prompt tooltip when the user selects the cell in Microsoft Excel.
- value
- Type:boolean
Remarks
The input prompt will only be shown if this value is True and the DataValidationRule.inputMessageDescription is not null.