CGXProperties::GetDataFooter

CGXData& GetDataFooter();

Return Value

A reference to the CGXData-object with the footer formatting.

Remarks

Returns a reference to the CGXData-object with the footer formatting.

The data-object is a table with 3 columns and 10 rows.

Column 1 contains left-aligned text, column 2 contains centered text and column 3 contains right-aligned text.

The data-object has several rows, so you can mix different fonts for the cells.

In the cells you can use predefined tokens:

  • $F: File name of the document

  • $A: Application name

  • $P: Page number

  • $N: Number of pages

  • $D: Date – you can specify the date formatting with an additional parameter, as for example $D{%h:%m}

  • $R: Register / Tabsheet name (if grid is used in a workbook).

Example

This example illustrates how you can specify the footer:

   CGXData& mapDataFooter
      = GetParam()->GetProperties()->GetDataFooter();
   // Date $d will be left-aligned
   mapDataFooter.StoreStyleRowCol(2, 2, CGXStyle()
      .SetValue("$d{%x}")   // {%x} is a parameter for the
                              // default date representation.
                              // See GXIntlStrFTime for this parameter.
      , gxCopy
      );
   // Page $p will be right-aligned
   mapDataFooter.StoreStyleRowCol(1, 3, CGXStyle()
      .SetValue("Page $p")
      .SetFont(CGXFont().SetSize(10).SetBold(TRUE))
      , gxCopy
      );

See Also

 CGXProperties::GetDataHeader  CGXProperties::OnPrintHeaderAndFooter  CGXProperties::SubstTokenText

CGXProperties

 Class Overview |  Class Members