Module Dferror.pkg

************************************************************************ * Copyright (c) 1997 Data Access Corporation, Miami Florida, * All rights reserved. * DataFlex is a registered trademark of Data Access Corporation. * * Module Name: * DFERROR.PKG ************************************************************************

Dferror.pkg (view source)
• import declarations
  • LanguageText.pkg (view source)
  • Windows.pkg (view source)
  • Msgbox.pkg (view source)
  • GlobalFunctionsProcedures.pkg (view source)
  • errornum.inc (view source)
    integer ghoErrorSource Move 0 to ghoErrorSource // ghoErrorSource object is expected to support this message Register_Function Extended_Error_Message returns string Include or define all useful symbols.
• Trapped_Errors_Array : array
  This array stores the set of trapped errors as toggled ranges starting with the errors that are trapped. The array should always contain 0 and MAX_ERROR_NUMBER + 1, which are the limits. If an array contained the following items... { 0, 5, 10, MAX_ERROR_NUMBER + 1 }. This would mean that errors 1 - 4 are trapped, 5 - 9 are ignored, and 10 through the rest are trapped.
  • IntegerfindErrorLE(Integer targetError)
    Find largest error LE targetError. Assumes array is sorted.
    • IntegerlowIndex
    • IntegerhiIndex
    • IntegermidIndex
    • IntegercurrError
  • initArray()
    Boundaries of the table are assumed to hold error limits.
  • IntegerisTrapped(Integer Error#)
    Return 1 if Error is trapped, 0 otherwise.
  • addError(Integer Error#)
    Add the error as long as it doesn't violate boundary conditions. This routine leaves the array unsorted.
  • handleError(Integer Error# Integer trapFlag)
    Set error to flagged state.
    • IntegerprevErrIndex
    • IntegerprevErrFlag
    • IntegerprevErrValue
    • IntegernextErrValue
  • Trap_Error(Integer Error#)
    *** Flag error as trappable
  • Ignore_Error(Integer Error#)
    *** Flag error as non-trappable
  • Trap_All()
    *** Flag all errors as trappable
  • Ignore_All()
    *** Flag all errors as non-trappable
• ErrorSystem : cObject
  • construct_object()
    • IntegerVerbose_State
    • IntegerCurrent_Error_Number
    • IntegerError_Line_Number
    • BooleanpbUnhandledErrorSupport
      If set false, this makes the error handler work the old way which does not use the new unhandled dialog. Only exists for compatibility reasons
    • BooleanpbShowErrorNumber
      shows error numbers with user errors. Only set this true if your application has meaningful numbers that helps the end user. Note that unhandled errors always show numbers. this is ignored if pbUnhandledErrorSupport is false
    • StringpsUnhandledErrorCaption
      This is the caption that appears for unhandled errors dialog box
    • StringpsUserErrorCaption
      This is the caption that appears for standard user errors
    • IntegerError_Processing_State
      Flag which is sent when error is being processed. This stops error recursion.
    • Integer[]pUserErrorsArray
      array of errors that we consider User Errors
    • IntegerBell_on_Find_Error_State
      This allows us to skip find errors (GT & LT) and to only ring a bell when these occur.
    • trappedErrors : Trapped_Errors_Array
  • StringHelp_Context(Integer Context_Type)
  • Trap_Error(Integer Error#)
    *** Catch and display error Error#.
  • Ignore_Error(Integer Error#)
    *** Pass error Error# on to the regular DataFlex error handler.
  • Trap_All()
    *** Catch and display all errors.
  • Ignore_All()
    *** Forward all error to regular DataFlex error handler.
  • StringError_Description(Integer Error# String ErrMsg)
    *** Build complete error description from Flexerrs and user error message.
    • StringFull_Error_Text
  • IntegerIs_Critical(Integer Error#)
    ** return true if an error number is critical
  • AddUserError(Integer iError)
    adds a user error to the array
    • Integer[]UserErrors
  • RemoveUserError(Integer iError)
    removes an error from the user array
    • Integer[]UserErrors
    • IntegeriIndex
    • IntegeriSize
  • RemoveAllUserErrors()
    removes all user errors
    • Integer[]UserErrors
  • BooleanIsUnhandledError(Integer iError)
    returns true if this is an unhandled error (i.e., not a user error
    • Integer[]UserErrors
  • UnhandledErrorDisplay(Integer iErrorLine String sMessage)
    • StringsCaption
    • StringsCRLF
  • Error_Report(Integer ErrNum Integer Err_Line String ErrMsg)
    *** Handle error event, displaying error info to user.
    • IntegeriReply
    • IntegeriIcon
    • StringsErrorText
    • StringsMess
    • StringsSource
    • StringsCaption
    • IntegeriSrcPos
    • IntegeriSrc
    • IntegeriTxtLen
    • BooleanbIsUnhandled
    • BooleanbUnhandledSupport
    • BooleanbCritical
    • BooleanbVerbose
  • StringHelp_Name()
    JJT- Note if you are using the WINDAF windows help system the following functions are not used. The functions below are used to construct a general help name for errors that are generated by the system. If processing comes here, then there was no module specific help found. These functions will provide a more general help name that appears in the form of SYSTEM..ERROR:#. All global errors should be places in the help file under this application and module name. *** Returns "ERROR:errornum" to supply error help.
  • StringApplication_Name()
  • StringModule_Name()
• Error_Info_Object : ErrorSystem
• UserError(String sMessage String sCaption)
  • StringsCapt

References (2):

Field References (0):