Important Notice

The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.

  ◄MSGraph► ◄Contents► ◄Index►                                    ◄Back►
 
  CONST
      { return values for _GrStatus }
      _GrOk                 =  0;
      _GrError              = -1;
      _GrModeNotSupported   = -2;
      _GrNotInProperMode    = -3;
      _GrInvalidParameter   = -4;
      _GrFontFileNotFound   = -5;
      _GrInvalidFontFile    = -6;
      _GrCorruptedFontFile  = -7;
      _GrInsufficientMemory = -8;
      _GrInvalidImageBuffer = -9;
      _GrNoOutput           =  1;
      _GrClipped            =  2;
      _GrParameterAltered   =  3;
 
  Unit:     MSGraph
 
  Context:  _GrStatus
 
  Description
 
    The function _GrStatus returns a value that describes the success
    of the most recently executed graphics procedure or function.
    Values less than zero are errors. Values greater than zero are
    warnings.
 
    Constant                Value  Meaning
    ═════════════════════   ═════  ═════════════════════════════════════
 
    _GrOk                    0     Successful graphics call
 
    _GrError                 -1    General graphics error
    _GrModeNotSupported      -2    Requested video mode not supported
    _GrNotInProperMode       -3    Routine works only in certain modes
    _GrInvalidParameter      -4    One or more parameters invalid
    _GrFontFileNotFound      -5    Matching font file not found
    _GrInvalidFontFile       -6    One or more font files invalid
    _GrCorruptedFontFile     -7    One or more font files inconsistent
    _GrInsufficientMemory    -8    Not enough memory to allocate buffer
                                   or to complete a _FloodFill operation
    _GrInvalidImageBuffer    -9    Image buffer data inconsistent
 
    _GrNoOutput              1     Nothing was done
    _GrClipped               2     Output was clipped to viewport
    _GrParameterAltered      3     One or more input parameters were
                                   altered to be within range, or one or
                                   more pairs of parameters were
                                   exchanged to be in the proper order
 
    To check for fatal errors:
 
       IF _GrStatus < _GrOk THEN { code to deal with fatal errors }
 
    To check for warnings:
 
       IF _GrStatus > _GrOk THEN { code to deal with warnings }
 
    To execute code only if the previous call succeeded:
 
       IF _GrStatus = _GrOk THEN { code to deal with success }