docs/latex/wx/richtextheaderfooterdata.tex

   1 \section{\class{wxRichTextHeaderFooterData}}\label{wxrichtextheaderfooterdata}
   2
   3
   4 This class represents header and footer data to be passed to the \helpref{wxRichTextPrinting}{wxrichtextprinting} and
   5 \helpref{wxRichTextPrintout}{wxrichtextprintout} classes.
   6
   7 Headers and footers can be specified independently for odd, even or both page sides. Different text can be specified
   8 for left, centre and right locations on the page, and the font and text colour can also
   9 be specified. You can specify the following keywords in header and footer text, which will
  10 be substituted for the actual values during printing and preview.
  11
  12 \begin{itemize}\itemsep=0pt
  13 \item @DATE@: the current date.
  14 \item @PAGESCNT@: the total number of pages.
  15 \item @PAGENUM@: the current page number.
  16 \item @TIME@: the current time.
  17 \item @TITLE@: the title of the document, as passed to the wxRichTextPrinting or wxRichTextLayout constructor.
  18 \end{itemize}
  19
  20 \wxheading{Derived from}
  21
  22 \helpref{wxObject}{wxobject}
  23
  24 \wxheading{Include files}
  25
  26 <wx/richtext/richtextprint.h>
  27
  28 \wxheading{Library}
  29
  30 \helpref{wxRichtext}{librarieslist}
  31
  32 \wxheading{Data structures}
  33
  34 These are the header and footer page identifiers, passed to functions such as SetFooterText to specify
  35 the odd or even page for the text:
  36
  37 \begin{verbatim}
  38 enum wxRichTextOddEvenPage {
  39     wxRICHTEXT_PAGE_ODD,
  40     wxRICHTEXT_PAGE_EVEN,
  41     wxRICHTEXT_PAGE_ALL,
  42 }
  43 \end{verbatim}
  44
  45 These are the location identifiers for passing to functions such as SetFooterText, to specify
  46 whether the text is on the left, centre or right of the page:
  47
  48 \begin{verbatim}
  49 enum wxRichTextPageLocation {
  50     wxRICHTEXT_PAGE_LEFT,
  51     wxRICHTEXT_PAGE_CENTRE,
  52     wxRICHTEXT_PAGE_RIGHT
  53 }
  54 \end{verbatim}
  55
  56 \latexignore{\rtfignore{\wxheading{Members}}}
  57
  58 \membersection{wxRichTextHeaderFooterData::wxRichTextHeaderFooterData}\label{wxrichtextheaderfooterdatawxrichtextheaderfooterdata}
  59
  60 \func{}{wxRichTextHeaderFooterData}{\void}
  61
  62 \func{}{wxRichTextHeaderFooterData}{\param{const wxRichTextHeaderFooterData\& }{data}}
  63
  64 Constructors.
  65
  66 \membersection{wxRichTextHeaderFooterData::Clear}\label{wxrichtextheaderfooterdataclear}
  67
  68 \func{void}{Clear}{\void}
  69
  70 Clears all text.
  71
  72 \membersection{wxRichTextHeaderFooterData::Copy}\label{wxrichtextheaderfooterdatacopy}
  73
  74 \func{void}{Copy}{\param{const wxRichTextHeaderFooterData\& }{data}}
  75
  76 Copies the data.
  77
  78 \membersection{wxRichTextHeaderFooterData::GetFont}\label{wxrichtextheaderfooterdatagetfont}
  79
  80 \constfunc{const wxFont\&}{GetFont}{\void}
  81
  82 Returns the font specified for printing the header and footer.
  83
  84 \membersection{wxRichTextHeaderFooterData::GetFooterMargin}\label{wxrichtextheaderfooterdatagetfootermargin}
  85
  86 \constfunc{int}{GetFooterMargin}{\void}
  87
  88 Returns the margin between the text and the footer.
  89
  90 \membersection{wxRichTextHeaderFooterData::GetFooterText}\label{wxrichtextheaderfooterdatagetfootertext}
  91
  92 \constfunc{wxString}{GetFooterText}{\param{wxRichTextOddEvenPage }{page = wxRICHTEXT\_PAGE\_EVEN}, \param{wxRichTextPageLocation }{location = wxRICHTEXT\_PAGE\_CENTRE}}
  93
  94 Returns the footer text on odd or even pages, and at a given position on the page (left, centre or right).
  95
  96 \membersection{wxRichTextHeaderFooterData::GetHeaderMargin}\label{wxrichtextheaderfooterdatagetheadermargin}
  97
  98 \constfunc{int}{GetHeaderMargin}{\void}
  99
 100 Returns the margin between the text and the header.
 101
 102 \membersection{wxRichTextHeaderFooterData::GetHeaderText}\label{wxrichtextheaderfooterdatagetheadertext}
 103
 104 \constfunc{wxString}{GetHeaderText}{\param{wxRichTextOddEvenPage }{page = wxRICHTEXT\_PAGE\_EVEN}, \param{wxRichTextPageLocation }{location = wxRICHTEXT\_PAGE\_CENTRE}}
 105
 106 Returns the header text on odd or even pages, and at a given position on the page (left, centre or right).
 107
 108 \membersection{wxRichTextHeaderFooterData::GetShowOnFirstPage}\label{wxrichtextheaderfooterdatagetshowonfirstpage}
 109
 110 \constfunc{bool}{GetShowOnFirstPage}{\void}
 111
 112 Returns \true if the header and footer will be shown on the first page.
 113
 114 \membersection{wxRichTextHeaderFooterData::GetText}\label{wxrichtextheaderfooterdatagettext}
 115
 116 \constfunc{wxString}{GetText}{\param{int }{headerFooter}, \param{wxRichTextOddEvenPage }{page}, \param{wxRichTextPageLocation }{location}}
 117
 118 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).
 119
 120 \membersection{wxRichTextHeaderFooterData::GetTextColour}\label{wxrichtextheaderfooterdatagettextcolour}
 121
 122 \constfunc{const wxColour\&}{GetTextColour}{\void}
 123
 124 Returns the text colour for drawing the header and footer.
 125
 126 \membersection{wxRichTextHeaderFooterData::Init}\label{wxrichtextheaderfooterdatainit}
 127
 128 \func{void}{Init}{\void}
 129
 130 Initialises the object.
 131
 132 \membersection{wxRichTextHeaderFooterData::SetFont}\label{wxrichtextheaderfooterdatasetfont}
 133
 134 \func{void}{SetFont}{\param{const wxFont\& }{font}}
 135
 136 Sets the font for drawing the header and footer.
 137
 138 \membersection{wxRichTextHeaderFooterData::SetFooterText}\label{wxrichtextheaderfooterdatasetfootertext}
 139
 140 \func{void}{SetFooterText}{\param{const wxString\& }{text}, \param{wxRichTextOddEvenPage }{page = wxRICHTEXT\_PAGE\_ALL}, \param{wxRichTextPageLocation }{location = wxRICHTEXT\_PAGE\_CENTRE}}
 141
 142 Sets the footer text on odd or even pages, and at a given position on the page (left, centre or right).
 143
 144 \membersection{wxRichTextHeaderFooterData::SetHeaderText}\label{wxrichtextheaderfooterdatasetheadertext}
 145
 146 \func{void}{SetHeaderText}{\param{const wxString\& }{text}, \param{wxRichTextOddEvenPage }{page = wxRICHTEXT\_PAGE\_ALL}, \param{wxRichTextPageLocation }{location = wxRICHTEXT\_PAGE\_CENTRE}}
 147
 148 Sets the header text on odd or even pages, and at a given position on the page (left, centre or right).
 149
 150 \membersection{wxRichTextHeaderFooterData::SetMargins}\label{wxrichtextheaderfooterdatasetmargins}
 151
 152 \func{void}{SetMargins}{\param{int }{headerMargin}, \param{int }{footerMargin}}
 153
 154 Sets the margins between text and header or footer, in tenths of a millimeter.
 155
 156 \membersection{wxRichTextHeaderFooterData::SetShowOnFirstPage}\label{wxrichtextheaderfooterdatasetshowonfirstpage}
 157
 158 \func{void}{SetShowOnFirstPage}{\param{bool }{showOnFirstPage}}
 159
 160 Pass \true to show the header or footer on first page (the default).
 161
 162 \membersection{wxRichTextHeaderFooterData::SetText}\label{wxrichtextheaderfooterdatasettext}
 163
 164 \func{void}{SetText}{\param{const wxString\& }{text}, \param{int }{headerFooter}, \param{wxRichTextOddEvenPage }{page}, \param{wxRichTextPageLocation }{location}}
 165
 166 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).
 167
 168 \membersection{wxRichTextHeaderFooterData::SetTextColour}\label{wxrichtextheaderfooterdatasettextcolour}
 169
 170 \func{void}{SetTextColour}{\param{const wxColour\& }{col}}
 171
 172 Sets the text colour for drawing the header and footer.
 173
 174 \membersection{wxRichTextHeaderFooterData::operator=}\label{wxrichtextheaderfooterdataoperatorassign}
 175
 176 \func{void operator}{operator=}{\param{const wxRichTextHeaderFooterData\& }{data}}
 177
 178 Assignment operator.
 179