Click above to get retro games delivered to your door ever month!

 CapBannerFlagGet() / CapBannerFlagSet()
------------------------------------------------------------------------------
 Purpose:
 Get or set the capture banner flag.

 Syntax:
 bFlag = CapBannerFlagGet( iLPTNum )
 bFlag = CapBannerFlagSet( iLPTNum, bNewFlag )

 Parameters:
 iLPTNum  The LPT device. 1=LPT1: 2=LPT2: 3=LPT3:
 bNewFlag The enable/disable banner flag.

 Returns:
 A boolean value (TRUE or FALSE).

 The CA-Clipper names for these functions:
 CapBanFlgGet() / CapBanFlgSet()

 Description:
 CapBannerFlagGet() is used to retrieve the current setting for the
 specified printer iLPTNum.

 CapBannerFlagSet() is used to set, using bNewFlag, whether a banner is to
 be printed before each print job on the specified printer iLPTNum.
 CapBannerFlagSet() also returns the previous setting.

 Returns TRUE if the banner flag is enabled, and FALSE if not, or if an
 error occurs.

 Example:
 // To disable the printing of a banner before print jobs on LPT1:
 bOldflag = CapBannerFlagSet( 1, FALSE)
 if ( NWErrorGet() = 0 )
    ? "Banners are now disabled for LPT1:"
 endif
 // To return the current state of the banner flag on LPT2:
 bFlagStatus = CapBannerFlagGet( 2 )
 if ( NWErrorGet() = 0 )
    ? The banner flag for LPT2: is", bFlagStatus
 endif

 Notes:
 If FALSE is returned, check NWErrorGet().