Functions and Directives

Function GraError() Foundation

Determines the error code of the last graphic function called.

GraError( [<oPS>] ) --> nErrorCode
The argument <oPS> specifies the presentation space from which the error code is retrieved. If the current window is an XbpCrt window, <oPS>is optional. If it is NIL, the return value of SetAppWindow():presSpace() is used. In all other cases <oPS> is not optional. It must be created either using XbpPresSpace():new() or a "Micro PS" must be requested from an Xbase Part using the method :lockPS(). After the call to GraError() the Micro PS must be released with :unlockPS().

The return value of GraError() is a numeric value. It indicates the error code of the last executed graphic function in <oPS>. If the return value is zero, the last graphic function was executed without error. A value not equal to zero indicates an output error.


The graphic functions of Xbase++ call system functions for the appropriate graphic output. Graphic output is strongly dependent on the hardware and accompanying drivers. The GRA subsystem is hardware-dependent to the same extent as the operating system. If graphic output does not occur as expected, the cause of error can be determined using GraError(). The error codes for GraError() are defined as constants in the #include file GRAERROR.CH.

GraError() returns the error code for the specified presentation space. This means each presentation space manages its own error code (see XbpPresSpace()).


If you see anything in the documentation that is not correct, does not match your experience with the particular feature or requires further clarification, please use this form to report a documentation issue.