dev_set_check — Specify the error handling in HDevelop.
dev_set_check( : : Mode : )
dev_set_check specifies how HDevelop has to react in case of
an error, i.e., if the return state of an operator is not H_MSG_TRUE (2).
Mode has the value 'give_error'---which is the
system default---an erroneous operator call will throw an exception,
that can be caught within the HDevelop program by the
However, if there is no surrounding
catch block in the
HDevelop program and the program is executed within HDevelop, the
program execution stops at the erroneous operator and an error message box
is opened to display the error text.
In addition, the appropriate operator call is entered into the
'Operator Window', so that the user can easily edit and possibly
correct the parameters of the erroneous operator call.
If the procedure was called from HDevEngine and the exception is
not caught within the HDevelop program, an
object is thrown and the procedure is left.
Mode is set to '~give_error', the error
will be ignored and the program continues with the next operator.
dev_set_check('~give_error') is intended to be used in connection with
dev_error_var, which allows to check the result state that is
returned by the operator calls.
Using the code export feature of HDevelop, the code that is generated
for this operator may have a different behavior than the related
For a detailed description of the code export of HDevelop graphics
operators into the different programming languages see in the
“HDevelop User's Guide” the chapter
General Aspects of Code Generation
Mode of error handling.
Default value: 'give_error'
dev_close_window () dev_open_window (0, 0, 512, 512, 'black', WindowHandle) dev_error_var (Error, 1) dev_set_check ('~give_error') FileName := 'wrong_name' read_image (Image, FileName) ReadError := Error if (ReadError != H_MSG_TRUE) write_string (WindowHandle, 'wrong file name: '+FileName) endif * Now the program will stop with an exception dev_set_check ('give_error') read_image (Image, FileName)
If the values of the specified parameters are correct,
dev_set_check returns TRUE. Otherwise, an
exception is raised and an error code returned.