Retro video games delivered to your door every month!
Click above to get retro games delivered to your door ever month!
X-Hacker.org- Novlib 3.30 Online Reference - <b> capbantxtget() / capbantxtset()</b> http://www.X-Hacker.org [<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 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().

See Also: CapBanNmeGet() / CapBanNmeSet() CapStart()

Online resources provided by: http://www.X-Hacker.org --- NG 2 HTML conversion by Dave Pearson