mac paths updated

[wxWidgets.git] / interface / richtext / richtextprint.h

diff --git a/interface/richtext/richtextprint.h b/interface/richtext/richtextprint.h
index ec68d4a03997ddac5e01141a23e468367d006ca9..2c70bdbf5d224bab0aabb8e921e384a1dfba564c 100644 (file)
--- a/interface/richtext/richtextprint.h
+++ b/interface/richtext/richtextprint.h
@@ -1,6 +1,6 @@
 /////////////////////////////////////////////////////////////////////////////
 // Name:        richtext/richtextprint.h
 /////////////////////////////////////////////////////////////////////////////
 // Name:        richtext/richtextprint.h

-// Purpose:     documentation for wxRichTextHeaderFooterData class
+// Purpose:     interface of wxRichTextHeaderFooterData

 // Author:      wxWidgets team
 // RCS-ID:      $Id$
 // Licence:     wxWindows license
 // Author:      wxWidgets team
 // RCS-ID:      $Id$
 // Licence:     wxWindows license


@@ -9,12 +9,12 @@
 /**
     @class wxRichTextHeaderFooterData
     @headerfile richtextprint.h wx/richtext/richtextprint.h
 /**
     @class wxRichTextHeaderFooterData
     @headerfile richtextprint.h wx/richtext/richtextprint.h

-    
-    
+
+

     This class represents header and footer data to be passed to the
     wxRichTextPrinting and
     wxRichTextPrintout classes.
     This class represents header and footer data to be passed to the
     wxRichTextPrinting and
     wxRichTextPrintout 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
     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


@@ -22,16 +22,16 @@
     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.
     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 wxRichTextPrinting or
     wxRichTextLayout constructor.
      @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 wxRichTextPrinting or
     wxRichTextLayout constructor.

-    
+

     @library{wxrichtext}
     @library{wxrichtext}

-    @category{FIXME}
+    @category{richtext}

 */
 class wxRichTextHeaderFooterData : public wxObject
 {
 */
 class wxRichTextHeaderFooterData : public wxObject
 {


@@ -41,7 +41,7 @@ public:
         Constructors.
     */
     wxRichTextHeaderFooterData();
         Constructors.
     */
     wxRichTextHeaderFooterData();

-        wxRichTextHeaderFooterData(const wxRichTextHeaderFooterData& data);
+    wxRichTextHeaderFooterData(const wxRichTextHeaderFooterData& data);

     //@}
 
     /**
     //@}
 
     /**


@@ -57,48 +57,48 @@ public:
     /**
         Returns the font specified for printing the header and footer.
     */
     /**
         Returns the font specified for printing the header and footer.
     */

-    const wxFont GetFont();
+    const wxFont GetFont() const;

 
     /**
         Returns the margin between the text and the footer.
     */
 
     /**
         Returns the margin between the text and the footer.
     */

-    int GetFooterMargin();
+    int GetFooterMargin() const;

 
     /**
         Returns the footer text on odd or even pages, and at a given position on the
         page (left, centre or right).
     */
     wxString GetFooterText(wxRichTextOddEvenPage page = wxRICHTEXT_PAGE_EVEN,
 
     /**
         Returns the footer text on odd or even pages, and at a given position on the
         page (left, centre or right).
     */
     wxString GetFooterText(wxRichTextOddEvenPage page = wxRICHTEXT_PAGE_EVEN,

-                           wxRichTextPageLocation location = wxRICHTEXT_PAGE_CENTRE);
+                           wxRichTextPageLocation location = wxRICHTEXT_PAGE_CENTRE) const;

 
     /**
         Returns the margin between the text and the header.
     */
 
     /**
         Returns the margin between the text and the header.
     */

-    int GetHeaderMargin();
+    int GetHeaderMargin() const;

 
     /**
         Returns the header text on odd or even pages, and at a given position on the
         page (left, centre or right).
     */
     wxString GetHeaderText(wxRichTextOddEvenPage page = wxRICHTEXT_PAGE_EVEN,
 
     /**
         Returns the header text on odd or even pages, and at a given position on the
         page (left, centre or right).
     */
     wxString GetHeaderText(wxRichTextOddEvenPage page = wxRICHTEXT_PAGE_EVEN,

-                           wxRichTextPageLocation location = wxRICHTEXT_PAGE_CENTRE);
+                           wxRichTextPageLocation location = wxRICHTEXT_PAGE_CENTRE) const;

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

-    bool GetShowOnFirstPage();
+    bool GetShowOnFirstPage() const;

 
     /**
         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).
     */
     wxString GetText(int headerFooter, wxRichTextOddEvenPage page,
 
     /**
         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).
     */
     wxString GetText(int headerFooter, wxRichTextOddEvenPage page,

-                     wxRichTextPageLocation location);
+                     wxRichTextPageLocation location) const;

 
     /**
         Returns the text colour for drawing the header and footer.
     */
 
     /**
         Returns the text colour for drawing the header and footer.
     */

-    const wxColour GetTextColour();
+    const wxColour GetTextColour() const;

 
     /**
         Initialises the object.
 
     /**
         Initialises the object.


@@ -156,23 +156,23 @@ public:
 };
 
 
 };
 
 

+

 /**
     @class wxRichTextPrintout
     @headerfile richtextprint.h wx/richtext/richtextprint.h
 /**
     @class wxRichTextPrintout
     @headerfile richtextprint.h wx/richtext/richtextprint.h

-    
+

     This class implements print layout for wxRichTextBuffer. Instead of using it
     directly, you
     should normally use the wxRichTextPrinting class.
     This class implements print layout for wxRichTextBuffer. Instead of using it
     directly, you
     should normally use the wxRichTextPrinting class.

-    
+

     @library{wxrichtext}
     @library{wxrichtext}

-    @category{FIXME}
+    @category{richtext}

 */
 class wxRichTextPrintout : public wxPrintout
 {
 public:
     /**
         )
 */
 class wxRichTextPrintout : public wxPrintout
 {
 public:
     /**
         )

-        

         Constructor.
     */
     wxRichTextPrintout();
         Constructor.
     */
     wxRichTextPrintout();


@@ -187,7 +187,7 @@ public:
     /**
         Returns the header and footer data associated with the printout.
     */
     /**
         Returns the header and footer data associated with the printout.
     */

-    const wxRichTextHeaderFooterData GetHeaderFooterData();
+    const wxRichTextHeaderFooterData GetHeaderFooterData() const;

 
     /**
         Gets the page information.
 
     /**
         Gets the page information.


@@ -198,7 +198,7 @@ public:
     /**
         Returns a pointer to the buffer being rendered.
     */
     /**
         Returns a pointer to the buffer being rendered.
     */

-    wxRichTextBuffer* GetRichTextBuffer();
+    wxRichTextBuffer* GetRichTextBuffer() const;

 
     /**
         Returns @true if the given page exists in the printout.
 
     /**
         Returns @true if the given page exists in the printout.


@@ -235,22 +235,22 @@ public:
 };
 
 
 };
 
 

+

 /**
     @class wxRichTextPrinting
     @headerfile richtextprint.h wx/richtext/richtextprint.h
 /**
     @class wxRichTextPrinting
     @headerfile richtextprint.h wx/richtext/richtextprint.h

-    
+

     This class provides a simple interface for performing wxRichTextBuffer printing
     and previewing. It uses wxRichTextPrintout for layout and rendering.
     This class provides a simple interface for performing wxRichTextBuffer printing
     and previewing. It uses wxRichTextPrintout for layout and rendering.

-    
+

     @library{wxrichtext}
     @library{wxrichtext}

-    @category{FIXME}
+    @category{richtext}

 */
 class wxRichTextPrinting : public wxObject
 {
 public:
     /**
         , @b wxWindow*@e parentWindow = @NULL)
 */
 class wxRichTextPrinting : public wxObject
 {
 public:
     /**
         , @b wxWindow*@e parentWindow = @NULL)

-        

         Constructor. Optionally pass a title to be used in the preview frame and
         printing wait dialog, and
         also a parent window for these windows.
         Constructor. Optionally pass a title to be used in the preview frame and
         printing wait dialog, and
         also a parent window for these windows.


@@ -262,19 +262,19 @@ public:
         for details.
     */
     wxString GetFooterText(wxRichTextOddEvenPage page = wxRICHTEXT_PAGE_EVEN,
         for details.
     */
     wxString GetFooterText(wxRichTextOddEvenPage page = wxRICHTEXT_PAGE_EVEN,

-                           wxRichTextPageLocation location = wxRICHTEXT_PAGE_CENTRE);
+                           wxRichTextPageLocation location = wxRICHTEXT_PAGE_CENTRE) const;

 
     /**
         Returns the internal wxRichTextHeaderFooterData object.
     */
 
     /**
         Returns the internal wxRichTextHeaderFooterData object.
     */

-    const wxRichTextHeaderFooterData GetHeaderFooterData();
+    const wxRichTextHeaderFooterData GetHeaderFooterData() const;

 
     /**
         A convenience function to get the header text. See wxRichTextHeaderFooterData
         for details.
     */
     wxString GetHeaderText(wxRichTextOddEvenPage page = wxRICHTEXT_PAGE_EVEN,
 
     /**
         A convenience function to get the header text. See wxRichTextHeaderFooterData
         for details.
     */
     wxString GetHeaderText(wxRichTextOddEvenPage page = wxRICHTEXT_PAGE_EVEN,

-                           wxRichTextPageLocation location = wxRICHTEXT_PAGE_CENTRE);
+                           wxRichTextPageLocation location = wxRICHTEXT_PAGE_CENTRE) const;

 
     /**
         Returns a pointer to the internal page setup data.
 
     /**
         Returns a pointer to the internal page setup data.


@@ -285,12 +285,12 @@ public:
         Returns the parent window to be used for the preview window and printing wait
         dialog.
     */
         Returns the parent window to be used for the preview window and printing wait
         dialog.
     */

-    wxWindow* GetParentWindow();
+    wxWindow* GetParentWindow() const;

 
     /**
         Returns the dimensions to be used for the preview window.
     */
 
     /**
         Returns the dimensions to be used for the preview window.
     */

-    const wxRect GetPreviewRect();
+    const wxRect GetPreviewRect() const;

 
     /**
         Returns a pointer to the internal print data.
 
     /**
         Returns a pointer to the internal print data.


@@ -300,7 +300,7 @@ public:
     /**
         Returns the title of the preview window or printing wait caption.
     */
     /**
         Returns the title of the preview window or printing wait caption.
     */

-    const wxString GetTitle();
+    const wxString GetTitle() const;

 
     /**
         Shows the page setup dialog.
 
     /**
         Shows the page setup dialog.


@@ -314,7 +314,7 @@ public:
     bool PreviewBuffer(const wxRichTextBuffer& buffer);
 
     /**
     bool PreviewBuffer(const wxRichTextBuffer& buffer);
 
     /**

-        Shows a preview window for the given file. @e richTextFile can be a text file
+        Shows a preview window for the given file. @a richTextFile can be a text file

         or XML file, or other file
         depending on the available file handlers.
     */
         or XML file, or other file
         depending on the available file handlers.
     */


@@ -326,7 +326,7 @@ public:
     bool PrintBuffer(const wxRichTextBuffer& buffer);
 
     /**
     bool PrintBuffer(const wxRichTextBuffer& buffer);
 
     /**

-        Prints the given file. @e richTextFile can be a text file or XML file, or other
+        Prints the given file. @a richTextFile can be a text file or XML file, or other

         file
         depending on the available file handlers.
     */
         file
         depending on the available file handlers.
     */


@@ -394,3 +394,4 @@ public:
     */
     void SetTitle(const wxString& title);
 };
     */
     void SetTitle(const wxString& title);
 };

+