====== HEADER Set_Printer Message ======


 
==== Description ====
 
The HEADER message is used to set the page headers. The font that is used by the HEADER message is set with the [[fontheadfoot_set_printer_message|FONTHEADFOOT]] message.
 
==== Parameters ====
 
The Header parameter is used to specify the header text. The ColLen parameter is used to specify the widths of each column in inches.
 

^Parameter\\ ^Description of Fields\\ ^Comments\\ ^Default\\ ^
|Parm1 - Header\\ |<1> Header\\ |"Header String" can contain:\\ 'P' Current page\\ 'D' Current date\\ 'T' Current time\\ 'F' File name\\ Left:@VM:Center:@VM:Right\\ @FM between lines\\ |""|
|Parm2 - ColLen\\ |<1> Column Lengths\\ |NOT USED\\ |""|
|Parm3 - ColHeader\\ |<1> Column Header\\ |NOT USED\\ |""|
|Parm4 - ColJust\\ |<1> Column Justifications\\ |NOT USED\\ |""||

 
==== Remarks ====
 
The header can contain special codes in single quotes to insert data into the header and control the output of the header. The 'D' code for date will use the Short Date format from the International section of the Windows Control Panel. Use the 'DL' code to print the date using the Long Date format from the International section of the Windows Control Panel. Use @FM to delimit lines in the header, and use @VM to separate the left, center, and right justified header text. The header will be placed just above the top margin. Make sure there is enough room for the header text and font above the top margin, otherwise the header will be clipped.
 
==== See Also ====
 
[[fontheadfoot_set_printer_message|FONTHEADFOOT]], [[footer_set_printer_message|FOOTER]] Set_Printer messages
 
==== Example ====
 
<code>
/* The following example shows how to use the HEADER message to set the column header and page header. The HEADER message creates 3 columns with the column lengths of 1, 2, and 3 inches.  */

declare function Set_Printer

stat = Set_Printer("INIT") ;* Start printing
header = @VM: "This is the main Header 'D'":@VM: "Page 'P'"

* Convert delimiters


* Set header
stat = Set_Printer("HEADER", header)
stat = Set_Printer("TERM") ;* End printing
 
 
</code>