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

 CapBanTxtGet() / CapBanTxtSet()
------------------------------------------------------------------------------
 Purpose:
 Get / set the capture banner text.

 Syntax:
 lpszTxt = CapBanTxtGet( iLPTNum )
 lpszTxt = CapBanTxtSet( iLPTNum, lpszNewTxt )

 Parameters:
 iLPTNum    The LPT device. 1=LPT1: 2=LPT2: 3=LPT3:
 lpszNewTxt The new banner text.

 Returns:
 A character string of length 14.

 Description:
 CapBanTxtGet() returns the text printed on banners preceding print
 jobs on the specified LPT device iLPTNum.

 CapBanTxtSet() sets the text to be printed to  lpszNewTxt and returns
 the previous text. If new banner text is set, the change only takes effect
 after CapStart() is called.

 Returns an empty string if there is no banner text, or if an error occurs.

 Example:
 // To display the current banner text on LPT1:
 lpszTextStr = CapBanTxtGet( 1 )
 if ( NWErrorGet() = 0 )
    ? "The current banner text on LPT1: is", lpszTextStr
 endif
 // To change the banner text for LPT2: to "JOB 56B":
 lpszOldTextStr = CapBanTxtSet( 2, "JOB 56B" )
 lpszNewTextStr = CapBanTxtGet( 1 )
 if ( !empty( lpszNewTextStr ) )
    ? "The banner text for LPT2: has been updated"
 endif

 Notes:
 If an empty string is returned, check NWErrorGet().