Class: Wx::RTC::RichTextHeaderFooterData

Inherits:
Object
  • Object
show all
Defined in:
lib/wx/doc/gen/rtc/rich_text_header_footer_data.rb

Overview

Note:

This class is untracked and should not be derived from nor instances extended!

This class represents header and footer data to be passed to the RichTextPrinting and 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 RichTextPrinting or Wx::RichTextLayout constructor.

  • @USER@: the user’s name (support for this macro was added in wxWidgets 3.2.8)

Category: Rich Text

Requires:

  • USE_PRINTING_ARCHITECTURE
  • USE_RICHTEXT

Instance Method Summary collapse

Methods inherited from Object

#clone, #dup, #is_same_as, #un_share

Constructor Details

#initialize ⇒ Wx::RTC::RichTextHeaderFooterData #initialize(data) ⇒ Wx::RTC::RichTextHeaderFooterData

Returns a new instance of RichTextHeaderFooterData.

Overloads:



78
 
# File 'lib/wx/doc/gen/rtc/rich_text_header_footer_data.rb', line 78

def initialize(*args) end

Instance Method Details

#clear ⇒ void

This method returns an undefined value.

Clears all text.



82
 
# File 'lib/wx/doc/gen/rtc/rich_text_header_footer_data.rb', line 82

def clear; end

#copy(data) ⇒ void

This method returns an undefined value.

Copies the data.

Parameters:



87
 
# File 'lib/wx/doc/gen/rtc/rich_text_header_footer_data.rb', line 87

def copy(data) end

#get_font ⇒ Wx::Font, Wx::FontInfo Also known as: font

Returns the font specified for printing the header and footer.

Returns:



91
 
# File 'lib/wx/doc/gen/rtc/rich_text_header_footer_data.rb', line 91

def get_font; end

#get_footer_margin ⇒ Integer Also known as: footer_margin

Returns the margin between the text and the footer.

Returns:

  • (Integer) 


96
 
# File 'lib/wx/doc/gen/rtc/rich_text_header_footer_data.rb', line 96

def get_footer_margin; end

#get_footer_text(page = Wx::RTC::RichTextOddEvenPage::RICHTEXT_PAGE_EVEN, location = Wx::RTC::RichTextPageLocation::RICHTEXT_PAGE_CENTRE) ⇒ String Also known as: footer_text

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

Parameters:

  • page (Wx::RichTextOddEvenPage) (defaults to: Wx::RTC::RichTextOddEvenPage::RICHTEXT_PAGE_EVEN)
  • location (Wx::RichTextPageLocation) (defaults to: Wx::RTC::RichTextPageLocation::RICHTEXT_PAGE_CENTRE)

Returns:

  • (String) 


103
 
# File 'lib/wx/doc/gen/rtc/rich_text_header_footer_data.rb', line 103

def get_footer_text(page=Wx::RTC::RichTextOddEvenPage::RICHTEXT_PAGE_EVEN, location=Wx::RTC::RichTextPageLocation::RICHTEXT_PAGE_CENTRE) end

#get_header_margin ⇒ Integer Also known as: header_margin

Returns the margin between the text and the header.

Returns:

  • (Integer) 


108
 
# File 'lib/wx/doc/gen/rtc/rich_text_header_footer_data.rb', line 108

def get_header_margin; end

#get_header_text(page = Wx::RTC::RichTextOddEvenPage::RICHTEXT_PAGE_EVEN, location = Wx::RTC::RichTextPageLocation::RICHTEXT_PAGE_CENTRE) ⇒ String Also known as: header_text

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

Parameters:

  • page (Wx::RichTextOddEvenPage) (defaults to: Wx::RTC::RichTextOddEvenPage::RICHTEXT_PAGE_EVEN)
  • location (Wx::RichTextPageLocation) (defaults to: Wx::RTC::RichTextPageLocation::RICHTEXT_PAGE_CENTRE)

Returns:

  • (String) 


115
 
# File 'lib/wx/doc/gen/rtc/rich_text_header_footer_data.rb', line 115

def get_header_text(page=Wx::RTC::RichTextOddEvenPage::RICHTEXT_PAGE_EVEN, location=Wx::RTC::RichTextPageLocation::RICHTEXT_PAGE_CENTRE) end

#get_show_on_first_page ⇒ Boolean Also known as: show_on_first_page

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

Returns:

  • (Boolean) 


120
 
# File 'lib/wx/doc/gen/rtc/rich_text_header_footer_data.rb', line 120

def get_show_on_first_page; end

#get_text(headerFooter, page, location) ⇒ String Also known as: text

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:

  • headerFooter (Integer)
  • page (Wx::RichTextOddEvenPage)
  • location (Wx::RichTextPageLocation)

Returns:

  • (String) 


128
 
# File 'lib/wx/doc/gen/rtc/rich_text_header_footer_data.rb', line 128

def get_text(headerFooter, page, location) end

#get_text_colour ⇒ Wx::Colour, ... Also known as: text_colour

Returns the text colour for drawing the header and footer.

Returns:



133
 
# File 'lib/wx/doc/gen/rtc/rich_text_header_footer_data.rb', line 133

def get_text_colour; end

#init ⇒ void

This method returns an undefined value.

Initialises the object.



138
 
# File 'lib/wx/doc/gen/rtc/rich_text_header_footer_data.rb', line 138

def init; end

#set_font(font) ⇒ void Also known as: font=

This method returns an undefined value.

Sets the font for drawing the header and footer.

Parameters:



143
 
# File 'lib/wx/doc/gen/rtc/rich_text_header_footer_data.rb', line 143

def set_font(font) end

#set_footer_text(text, page = Wx::RTC::RichTextOddEvenPage::RICHTEXT_PAGE_ALL, location = Wx::RTC::RichTextPageLocation::RICHTEXT_PAGE_CENTRE) ⇒ void Also known as: footer_text=

This method returns an undefined value.

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

Parameters:

  • text (String)
  • page (Wx::RichTextOddEvenPage) (defaults to: Wx::RTC::RichTextOddEvenPage::RICHTEXT_PAGE_ALL)
  • location (Wx::RichTextPageLocation) (defaults to: Wx::RTC::RichTextPageLocation::RICHTEXT_PAGE_CENTRE) 


151
 
# File 'lib/wx/doc/gen/rtc/rich_text_header_footer_data.rb', line 151

def set_footer_text(text, page=Wx::RTC::RichTextOddEvenPage::RICHTEXT_PAGE_ALL, location=Wx::RTC::RichTextPageLocation::RICHTEXT_PAGE_CENTRE) end

#set_header_text(text, page = Wx::RTC::RichTextOddEvenPage::RICHTEXT_PAGE_ALL, location = Wx::RTC::RichTextPageLocation::RICHTEXT_PAGE_CENTRE) ⇒ void Also known as: header_text=

This method returns an undefined value.

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

Parameters:

  • text (String)
  • page (Wx::RichTextOddEvenPage) (defaults to: Wx::RTC::RichTextOddEvenPage::RICHTEXT_PAGE_ALL)
  • location (Wx::RichTextPageLocation) (defaults to: Wx::RTC::RichTextPageLocation::RICHTEXT_PAGE_CENTRE) 


159
 
# File 'lib/wx/doc/gen/rtc/rich_text_header_footer_data.rb', line 159

def set_header_text(text, page=Wx::RTC::RichTextOddEvenPage::RICHTEXT_PAGE_ALL, location=Wx::RTC::RichTextPageLocation::RICHTEXT_PAGE_CENTRE) end

#set_margins(headerMargin, footerMargin) ⇒ void

This method returns an undefined value.

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

Parameters:

  • headerMargin (Integer)
  • footerMargin (Integer) 


166
 
# File 'lib/wx/doc/gen/rtc/rich_text_header_footer_data.rb', line 166

def set_margins(headerMargin, footerMargin) end

#set_show_on_first_page(showOnFirstPage) ⇒ void Also known as: show_on_first_page=

This method returns an undefined value.

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

Parameters:

  • showOnFirstPage (Boolean) 


171
 
# File 'lib/wx/doc/gen/rtc/rich_text_header_footer_data.rb', line 171

def set_show_on_first_page(showOnFirstPage) end

#set_text(text, headerFooter, page, location) ⇒ void

This method returns an undefined value.

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:

  • text (String)
  • headerFooter (Integer)
  • page (Wx::RichTextOddEvenPage)
  • location (Wx::RichTextPageLocation) 


180
 
# File 'lib/wx/doc/gen/rtc/rich_text_header_footer_data.rb', line 180

def set_text(text, headerFooter, page, location) end

#set_text_colour(col) ⇒ void Also known as: text_colour=

This method returns an undefined value.

Sets the text colour for drawing the header and footer.

Parameters:



185
 
# File 'lib/wx/doc/gen/rtc/rich_text_header_footer_data.rb', line 185

def set_text_colour(col) end