Phoenix Logo

phoenix_title wx.richtext.RichTextHeaderFooterData

This class represents header and footer data to be passed to the wx.richtext.RichTextPrinting and wx.richtext.RichTextPrintout classes.

Headers and footers can be specified independently for odd, even or both page sides. Different text can be specified for left, centre and right locations on the page, and the font and text colour can also be specified.

You can specify the following keywords in header and footer text, which will be substituted for the actual values during printing and preview.

  • @``DATE``@: the current date.
  • @``PAGESCNT``@: the total number of pages.
  • @``PAGENUM``@: the current page number.
  • @``TIME``@: the current time.
  • @``TITLE``@: the title of the document, as passed to the wx.richtext.RichTextPrinting or RichTextLayout constructor.

class_hierarchy Class Hierarchy

Inheritance diagram for class RichTextHeaderFooterData:

method_summary Methods Summary

__init__ Constructors.
Clear Clears all text.
Copy Copies the data.
GetFont Returns the font specified for printing the header and footer.
GetFooterMargin Returns the margin between the text and the footer.
GetFooterText Returns the footer text on odd or even pages, and at a given position on the page (left, centre or right).
GetHeaderMargin Returns the margin between the text and the header.
GetHeaderText Returns the header text on odd or even pages, and at a given position on the page (left, centre or right).
GetShowOnFirstPage Returns True if the header and footer will be shown on the first page.
GetText Helper function for getting the header or footer text, odd or even pages, and at a given position on the page (left, centre or right).
GetTextColour Returns the text colour for drawing the header and footer.
Init Initialises the object.
SetFont Sets the font for drawing the header and footer.
SetFooterText Sets the footer text on odd or even pages, and at a given position on the page (left, centre or right).
SetHeaderText Sets the header text on odd or even pages, and at a given position on the page (left, centre or right).
SetMargins Sets the margins between text and header or footer, in tenths of a millimeter.
SetShowOnFirstPage Pass True to show the header or footer on first page (the default).
SetText Helper function for setting the header or footer text, odd or even pages, and at a given position on the page (left, centre or right).
SetTextColour Sets the text colour for drawing the header and footer.

api Class API



class wx.richtext.RichTextHeaderFooterData(Object)

Possible constructors:

RichTextHeaderFooterData()

RichTextHeaderFooterData(data)

This class represents header and footer data to be passed to the RichTextPrinting and RichTextPrintout classes.


Methods



__init__(self, *args, **kw)

Constructors.

overload Overloaded Implementations:



__init__ (self)



__init__ (self, data)

Parameters:data (wx.richtext.RichTextHeaderFooterData) –





Clear(self)

Clears all text.



Copy(self, data)

Copies the data.

Parameters:data (wx.richtext.RichTextHeaderFooterData) –


GetFont(self)

Returns the font specified for printing the header and footer.

Return type:Font


GetFooterMargin(self)

Returns the margin between the text and the footer.

Return type:int


GetFooterText(self, page=RICHTEXT_PAGE_EVEN, location=RICHTEXT_PAGE_CENTRE)

Returns the footer text on odd or even pages, and at a given position on the page (left, centre or right).

Parameters:
Return type:

string



GetHeaderMargin(self)

Returns the margin between the text and the header.

Return type:int


GetHeaderText(self, page=RICHTEXT_PAGE_EVEN, location=RICHTEXT_PAGE_CENTRE)

Returns the header text on odd or even pages, and at a given position on the page (left, centre or right).

Parameters:
Return type:

string



GetShowOnFirstPage(self)

Returns True if the header and footer will be shown on the first page.

Return type:bool


GetText(self, headerFooter, page, location)

Helper function for getting the header or footer text, odd or even pages, and at a given position on the page (left, centre or right).

Parameters:
Return type:

string



GetTextColour(self)

Returns the text colour for drawing the header and footer.

Return type:Colour


Init(self)

Initialises the object.



SetFont(self, font)

Sets the font for drawing the header and footer.

Parameters:font (wx.Font) –


SetFooterText(self, text, page=RICHTEXT_PAGE_ALL, location=RICHTEXT_PAGE_CENTRE)

Sets the footer text on odd or even pages, and at a given position on the page (left, centre or right).

Parameters:


SetHeaderText(self, text, page=RICHTEXT_PAGE_ALL, location=RICHTEXT_PAGE_CENTRE)

Sets the header text on odd or even pages, and at a given position on the page (left, centre or right).

Parameters:


SetMargins(self, headerMargin, footerMargin)

Sets the margins between text and header or footer, in tenths of a millimeter.

Parameters:
  • headerMargin (int) –
  • footerMargin (int) –


SetShowOnFirstPage(self, showOnFirstPage)

Pass True to show the header or footer on first page (the default).

Parameters:showOnFirstPage (bool) –


SetText(self, text, headerFooter, page, location)

Helper function for setting the header or footer text, odd or even pages, and at a given position on the page (left, centre or right).

Parameters:


SetTextColour(self, col)

Sets the text colour for drawing the header and footer.

Parameters:col (wx.Colour) –

Properties



Font

See GetFont and SetFont



FooterMargin

See GetFooterMargin



FooterText

See GetFooterText and SetFooterText



HeaderMargin

See GetHeaderMargin



HeaderText

See GetHeaderText and SetHeaderText



ShowOnFirstPage

See GetShowOnFirstPage and SetShowOnFirstPage



TextColour

See GetTextColour and SetTextColour