X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/4209475ced5240eb3ce516767e7c9a0a74d12bc7..92c0fc34c104c8d7c12d6a3b78ea232690fc23f4:/interface/wx/html/htmprint.h diff --git a/interface/wx/html/htmprint.h b/interface/wx/html/htmprint.h index a7dd53b286..62b011d369 100644 --- a/interface/wx/html/htmprint.h +++ b/interface/wx/html/htmprint.h @@ -2,8 +2,7 @@ // Name: html/htmprint.h // Purpose: interface of wxHtmlDCRenderer // Author: wxWidgets team -// RCS-ID: $Id$ -// Licence: wxWindows license +// Licence: wxWindows licence ///////////////////////////////////////////////////////////////////////////// /** @@ -91,13 +90,50 @@ public: void SetDC(wxDC* dc, double pixel_scale = 1.0); /** - Sets fonts. See wxHtmlWindow::SetFonts for detailed description. + This function sets font sizes and faces. + + @param normal_face + This is face name for normal (i.e. non-fixed) font. + It can be either empty string (then the default face is chosen) or + platform-specific face name. Examples are "helvetica" under Unix or + "Times New Roman" under Windows. + @param fixed_face + The same thing for fixed face ( \..\ ) + @param sizes + This is an array of 7 items of int type. + The values represent size of font with HTML size from -2 to +4 + ( \ to \ ). + Default sizes are used if sizes is @NULL. + + Default font sizes are defined by constants wxHTML_FONT_SIZE_1, + wxHTML_FONT_SIZE_2, ..., wxHTML_FONT_SIZE_7. + Note that they differ among platforms. Default face names are empty strings. @see SetSize() */ void SetFonts(const wxString& normal_face, const wxString& fixed_face, const int* sizes = NULL); + /** + Sets font sizes to be relative to the given size or the system + default size; use either specified or default font + + @param size + Point size of the default HTML text + @param normal_face + This is face name for normal (i.e. non-fixed) font. It can be + either empty string (then the default face is chosen) or + platform-specific face name. Examples are "helvetica" under + Unix or "Times New Roman" under Windows. + @param fixed_face + The same thing for fixed face ( \..\ ) + + @see SetSize() + */ + void SetStandardFonts(int size = -1, + const wxString& normal_face = wxEmptyString, + const wxString& fixed_face = wxEmptyString); + /** Assign text to the renderer. Render() then draws the text onto DC. @@ -116,7 +152,7 @@ public: /** Set size of output rectangle, in pixels. Note that you @b can't change - width of the rectangle between calls to wxHtmlDCRenderer::Render! + width of the rectangle between calls to Render() ! (You can freely change height.) */ void SetSize(int width, int height); @@ -153,6 +189,14 @@ public: wxHtmlEasyPrinting(const wxString& name = "Printing", wxWindow* parentWindow = NULL); + /** + Returns the current name being used for preview frames and setup + dialogs. + + @since 2.8.11 / 2.9.1 + */ + const wxString& GetName() const; + /** Returns a pointer to wxPageSetupDialogData instance used by this class. You can set its parameters (via SetXXXX methods). @@ -222,10 +266,26 @@ public: const wxString& basepath = wxEmptyString); /** - Sets fonts. See wxHtmlWindow::SetFonts for detailed description. + Sets fonts. See wxHtmlDCRenderer::SetFonts for detailed description. */ void SetFonts(const wxString& normal_face, const wxString& fixed_face, const int* sizes = NULL); + + /** + Sets the name used for preview frames and setup dialogs. + + @since 2.8.11 / 2.9.1 + */ + void SetName(const wxString& name); + + /** + Sets default font sizes and/or default font size. + See wxHtmlDCRenderer::SetStandardFonts for detailed description. + @see SetFonts() + */ + void SetStandardFonts(int size = -1, + const wxString& normal_face = wxEmptyString, + const wxString& fixed_face = wxEmptyString); /** Set page footer. The following macros can be used inside it: @@ -287,6 +347,12 @@ private: }; +enum { + wxPAGE_ODD, + wxPAGE_EVEN, + wxPAGE_ALL +}; + /** @class wxHtmlPrintout @@ -311,7 +377,8 @@ public: static void AddFilter(wxHtmlFilter* filter); /** - Sets fonts. See wxHtmlWindow::SetFonts for detailed description. + This function sets font sizes and faces. See wxHtmlWindow::SetFonts + for detailed description. */ void SetFonts(const wxString& normal_face, const wxString& fixed_face, const int* sizes = NULL);