9.7 Error object

Description

You can enable/disable single error messages and/or query captions with the Error object. This object requires an index to specify which error message shall be responded. You can use the Error constants for this index (e. g. Error[ERROR_SYNTAX].Enabled). A description of the errors can be found at the error messages.

List of methods/properties

NameTypeShort description
EnabledPropertySpecifies wether an error message is enabled
TitlePropertyThe title of an error message
MessagePropertyThe content of an error message

Enabled

Description

If this switch is activated then the error message will be displayed if necessary. If all error messages have been disabled using the Errors object this switch is ineffective.

Syntax

1
Error[Index].Enabled

Data type

Switch

Type

Property

Example

1
2
$
Error[ERROR_READONLY].Enabled = False
At the end the error message for the write access on read-only values whould be disabled.

Title

Description

This property returns the title of an error message used in the title of the error message window. This value depends on the chosen language of the Destiny.dll.

Syntax

1
Error[Index].Title

Data type

String

Type

Property, read-only, depends on language

Example

1
2
$
a[1] = Error[ERROR_SYNTAX].Title
a[1] whould be at the end: "Error 1: Syntax" (if Destiny.Language whould be 0 then a[1] whould be a german title)

Message

Description

This property returns the message used in the body of the error message window. This value depends on the chosen language of the Destiny.dll.

Syntax

1
Error[Index].Message

Data type

String

Type

Property, read-only, depends on language

Example

1
2
$
a[1] = Error[ERROR_SYNTAX].Message
a[1] whould be at the end: "The syntax is invalid!" (if Destiny.Language whould be 0 then a[1] whould be a german message)