Forums     Knowledge Base     OfficeWriter Online     
 
 
This documentation is for
OfficeWriter v3.8.1
ASP/COM Platform

View Docs for Another
Version or Platform

ExcelApplication in Depth > Formatting Headers and Footers

ExcelApplication is not
available in ExcelWriterSE.

Formatting Headers and Footers

Formatting Headers and Footers with ExcelWriter

ExcelWriter allows you to create and format headers and footers for your spreadsheet in script using the the PageSetup object properties LeftFooter, CenterFooter, RightFooter, LeftHeader, CenterHeader, and RightHeader.

To format a header or footer in script, include formatting codes within the ExcelWriter header/footer property. For example, the following displays the center header text in bold Tahoma:

	ws.PageSetUp.CenterHeader = "&""Tahoma""&BFormatting Headers and Footers&B"

The following example demonstrates formatting headers and footers in an ExcelWriter script.

<%@ Language=VBScript %>
<% Option Explicit %>
<!-- METADATA TYPE="TypeLib" UUID="{7BCD2133-64A0-4770-843C-090637114583}" -->
<%
Dim oXLW
Dim oWS

Set oXLW = Server.CreateObject("Softartisans.ExcelWriter")
Set oWS = oXLW.Worksheets(1)

oWS.Cells(2,1).Value = "To see the headers and footers, open the File menu, "
oWS.Cells(3,1).Value = "select Page Setup, and select Header/Footer."

'---Format the headers and footers using VBA format codes
oWS.PageSetUp.LeftHeader = "&""Tahoma, Bold""&16&ESoftArtisans&E"
oWS.PageSetUp.CenterHeader = "&""Tahoma""&IFormatting Headers/Footers&I"
oWS.PageSetUp.RightHeader = "&""Tahoma""&A"
oWS.PageSetUp.LeftFooter = "&""Tahoma""&D"
oWS.PageSetUp.CenterFooter = "&""Tahoma""&T"
oWS.PageSetUp.RightFooter = "&""Tahoma""Page &P"

oXLW.Save "out.xls", saOpenInPlace
Set oXLW = Nothing
%>
Formatting Codes for Headers and Footers
&LLeft aligns the characters that follow.
&CCenters the characters that follow.
&RRight aligns the characters that follow.
&ETurns double-underline on or off.
&XTurns superscript on or off.
&YTurns subscript on or off.
&BTurns bold on or off.
&ITurns italic on or off.
&UTurns underline on or off.
&STurns strikethrough on or off.
&DPrints the current date.
&TPrints the current time.
&FPrints the name of the document.
&APrints the name of the worksheet.
&PPrints the page number.
&P+numberPrints the page number plus the specified number.
&P-numberPrints the page number minus the specified number.
&&Prints a single ampersand.
&"font name"Prints the characters that follow in the specified font size.

Important: In ASP, the font name must be within double quotation marks, as in the following example,
ws.PageSetUp.CenterHeader = "&""Tahoma""&Center Header"
&nnPrints the characters that follow in the specified font size. Use a two digit number to specify a size in points.
&NPrints the total number of pages in the document.

Formatting Headers and Footers in Microsoft Excel

When opening an existing Excel spreadsheet, ExcelWriter will preserve the header and footer formatting created in Excel. However, if you change the header/footer text in your ExcelWriter script and do not include Formatting Codes, the formatting created in Excel will be overwritten, and default formatting applied. To preserve header/footer formatting created in Excel, do not change header/footer text in script. Alternatively, format headers and footers in script.

To format spreadsheet headers and footers in Excel and preserve the formatting in ExcelWriter:

  1. In Microsoft Excel, open the File menu and select Page Setup...

  2. Select the Header/Footer tab.

  3. Select a header and/or footer from the drop-down list.



    Or, create a custom header/footer.



  4. Save the spreadsheet.

  5. In an ExcelWriter script, open the spreadsheet containing headers/footers. Use either ExcelTemplate or ExcelApplication.Open to open the spreadsheet.

  6. Modify the spreadsheet in script. Do not change the text of headers and footers; if you do, the original formatting will be overwritten, and default formatting applied.



Copyright 2007 © SoftArtisans, Inc. All Rights Reserved.