///////////////////////////////////////////////////////////////////////////// // Name: cmndata.h // Purpose: interface of print wx*Data classes // Author: wxWidgets team // Licence: wxWindows licence ///////////////////////////////////////////////////////////////////////////// /** @class wxPrintPageRange This class represents a range of pages to be printed. @library{wxcore} @category{printing,data} @see wxPrintDialogData @since 3.3.0 */ class wxPrintPageRange { public: /// Default constructor creates an uninitialized range. wxPrintPageRange() = default; /** Constructor creating a range from @a from to @a to (inclusive). Parameters must be valid, i.e. @a from must be strictly positive and @a to must be greater or equal to @a from. */ wxPrintPageRange(int from, int to); /// Return @true if both components are initialized correctly. bool IsValid() const; /// Return the number of pages in this range if it is valid. int GetNumberOfPages() const; int fromPage = 0; int toPage = 0; }; /** Synonym for a vector of page ranges. @since 3.3.0 */ using wxPrintPageRanges = std::vector; /** @class wxPageSetupDialogData This class holds a variety of information related to wxPageSetupDialog. It contains a wxPrintData member which is used to hold basic printer configuration data (as opposed to the user-interface configuration settings stored by wxPageSetupDialogData). @library{wxcore} @category{printing,data} @see @ref overview_printing, wxPageSetupDialog */ class wxPageSetupDialogData : public wxObject { public: /** Default constructor. */ wxPageSetupDialogData(); /** Copy constructor. */ wxPageSetupDialogData(const wxPageSetupDialogData& data); /** Construct an object from a print data object. */ wxPageSetupDialogData(const wxPrintData& printData); /** Destructor. */ virtual ~wxPageSetupDialogData(); /** Enables or disables the "Help" button (Windows only). */ void EnableHelp(bool flag); /** Enables or disables the margin controls (Windows only). */ void EnableMargins(bool flag); /** Enables or disables the orientation control (Windows only). */ void EnableOrientation(bool flag); /** Enables or disables the paper size control (Windows only). */ void EnablePaper(bool flag); /** Enables or disables the "Printer" button, which invokes a printer setup dialog. */ void EnablePrinter(bool flag); /** Returns @true if the dialog will simply return default printer information (such as orientation) instead of showing a dialog (Windows only). */ bool GetDefaultInfo() const; /** Returns @true if the page setup dialog will take its minimum margin values from the currently selected printer properties (Windows only). */ bool GetDefaultMinMargins() const; /** Returns @true if the printer setup button is enabled. */ bool GetEnableHelp() const; /** Returns @true if the margin controls are enabled (Windows only). */ bool GetEnableMargins() const; /** Returns @true if the orientation control is enabled (Windows only). */ bool GetEnableOrientation() const; /** Returns @true if the paper size control is enabled (Windows only). */ bool GetEnablePaper() const; /** Returns @true if the printer setup button is enabled. */ bool GetEnablePrinter() const; /** Returns the right (x) and bottom (y) margins in millimetres. */ wxPoint GetMarginBottomRight() const; /** Returns the left (x) and top (y) margins in millimetres. */ wxPoint GetMarginTopLeft() const; /** Returns the right (x) and bottom (y) minimum margins the user can enter (Windows only). Units are in millimetres. */ wxPoint GetMinMarginBottomRight() const; /** Returns the left (x) and top (y) minimum margins the user can enter (Windows only). Units are in millimetres. */ wxPoint GetMinMarginTopLeft() const; /** Returns the paper id (stored in the internal wxPrintData object). @see wxPrintData::SetPaperId() */ wxPaperSize GetPaperId() const; /** Returns the paper size in millimetres. */ wxSize GetPaperSize() const; /** Returns a reference to the print data associated with this object. */ wxPrintData& GetPrintData(); const wxPrintData& GetPrintData() const; /** Returns @true if the print data associated with the dialog data is valid. This can return @false on Windows if the current printer is not set, for example. On all other platforms, it returns @true. */ bool IsOk() const; /** Pass @true if the dialog will simply return default printer information (such as orientation) instead of showing a dialog (Windows only). */ void SetDefaultInfo(bool flag); /** Pass @true if the page setup dialog will take its minimum margin values from the currently selected printer properties (Windows only). Units are in millimetres. */ void SetDefaultMinMargins(bool flag); /** Sets the right (x) and bottom (y) margins in millimetres. */ void SetMarginBottomRight(const wxPoint& pt); /** Sets the left (x) and top (y) margins in millimetres. */ void SetMarginTopLeft(const wxPoint& pt); /** Sets the right (x) and bottom (y) minimum margins the user can enter (Windows only). Units are in millimetres. */ void SetMinMarginBottomRight(const wxPoint& pt); /** Sets the left (x) and top (y) minimum margins the user can enter (Windows only). Units are in millimetres. */ void SetMinMarginTopLeft(const wxPoint& pt); /** Sets the paper size id. Calling this function overrides the explicit paper dimensions passed in SetPaperSize(). @see wxPrintData::SetPaperId() */ void SetPaperId(wxPaperSize id); /** Sets the paper size in millimetres. If a corresponding paper id is found, it will be set in the internal wxPrintData object, otherwise the paper size overrides the paper id. */ void SetPaperSize(const wxSize& size); /** Sets the print data associated with this object. */ void SetPrintData(const wxPrintData& printData); /** Assigns print data to this object. */ wxPageSetupDialogData& operator =(const wxPrintData& data); /** Assigns page setup data to this object. */ wxPageSetupDialogData& operator =(const wxPageSetupDialogData& data); }; /** Enumeration of various printer bin sources. @see wxPrintData::SetBin() */ enum wxPrintBin { wxPRINTBIN_DEFAULT, wxPRINTBIN_ONLYONE, wxPRINTBIN_LOWER, wxPRINTBIN_MIDDLE, wxPRINTBIN_MANUAL, wxPRINTBIN_ENVELOPE, wxPRINTBIN_ENVMANUAL, wxPRINTBIN_AUTO, wxPRINTBIN_TRACTOR, wxPRINTBIN_SMALLFMT, wxPRINTBIN_LARGEFMT, wxPRINTBIN_LARGECAPACITY, wxPRINTBIN_CASSETTE, wxPRINTBIN_FORMSOURCE, wxPRINTBIN_USER, }; /** @class wxPrintData This class holds a variety of information related to printers and printer device contexts. This class is used to create a wxPrinterDC and a wxPostScriptDC. It is also used as a data member of wxPrintDialogData and wxPageSetupDialogData, as part of the mechanism for transferring data between the print dialogs and the application. @library{wxcore} @category{printing,data} @see @ref overview_printing, wxPrintDialog, wxPageSetupDialog, wxPrintDialogData, wxPageSetupDialogData, @ref overview_cmndlg_print, wxPrinterDC, wxPostScriptDC */ class wxPrintData : public wxObject { public: /** Default constructor. */ wxPrintData(); /** Copy constructor. */ wxPrintData(const wxPrintData& data); /** Destructor. */ virtual ~wxPrintData(); /** Returns the current bin (papersource). By default, the system is left to select the bin (@c wxPRINTBIN_DEFAULT is returned). See SetBin() for the full list of bin values. */ wxPrintBin GetBin() const; /** Returns @true if collation is on. */ bool GetCollate() const; /** Returns @true if colour printing is on. */ bool GetColour() const; /** Returns the duplex mode. One of wxDUPLEX_SIMPLEX, wxDUPLEX_HORIZONTAL, wxDUPLEX_VERTICAL. */ wxDuplexMode GetDuplex() const; /** Returns the number of copies requested by the user. */ int GetNoCopies() const; /** Gets the orientation. This can be wxLANDSCAPE or wxPORTRAIT. */ wxPrintOrientation GetOrientation() const; /** Returns the paper size id. @see SetPaperId() */ wxPaperSize GetPaperId() const; /** Returns the printer name. If the printer name is the empty string, it indicates that the default printer should be used. */ const wxString& GetPrinterName() const; /** Returns the current print quality. This can be a positive integer, denoting the number of dots per inch, or one of the following identifiers: - wxPRINT_QUALITY_HIGH - wxPRINT_QUALITY_MEDIUM - wxPRINT_QUALITY_LOW - wxPRINT_QUALITY_DRAFT On input you should pass one of these identifiers, but on return you may get back a positive integer indicating the current resolution setting. */ wxPrintQuality GetQuality() const; /** Returns @true if the print data is valid for using in print dialogs. This can return @false on Windows if the current printer is not set, for example. On all other platforms, it returns @true. */ bool IsOk() const; /** Sets the current bin. */ void SetBin(wxPrintBin flag); /** Sets collation to on or off. */ void SetCollate(bool flag); /** Sets colour printing on or off. */ void SetColour(bool flag); /** Returns the duplex mode. One of wxDUPLEX_SIMPLEX, wxDUPLEX_HORIZONTAL, wxDUPLEX_VERTICAL. */ void SetDuplex(wxDuplexMode mode); /** Sets the default number of copies to be printed out. */ void SetNoCopies(int n); /** Sets the orientation. This can be wxLANDSCAPE or wxPORTRAIT. */ void SetOrientation(wxPrintOrientation orientation); /** Sets the paper id. This indicates the type of paper to be used. For a mapping between paper id, paper size and string name, see wxPrintPaperDatabase in @c "paper.h" (not yet documented). @see SetPaperSize() */ void SetPaperId(wxPaperSize paperId); /** Sets custom paper size. This method can be used to set up custom paper size. When using a standard size, prefer to use SetPaperId() instead. */ void SetPaperSize(const wxSize& size); /** Sets the printer name. This can be the empty string to indicate that the default printer should be used. */ void SetPrinterName(const wxString& printerName); /** Sets the desired print quality. This can be a positive integer, denoting the number of dots per inch, or one of the following identifiers: - wxPRINT_QUALITY_HIGH - wxPRINT_QUALITY_MEDIUM - wxPRINT_QUALITY_LOW - wxPRINT_QUALITY_DRAFT On input you should pass one of these identifiers, but on return you may get back a positive integer indicating the current resolution setting. */ void SetQuality(wxPrintQuality quality); /** Assigns print data to this object. */ wxPrintData& operator =(const wxPrintData& data); wxString GetFilename() const; void SetFilename( const wxString &filename ); wxPrintMode GetPrintMode() const ; void SetPrintMode(wxPrintMode printMode) ; }; /** @class wxPrintDialogData This class holds information related to the visual characteristics of wxPrintDialog. It contains a wxPrintData object with underlying printing settings. @library{wxcore} @category{printing,cmndlg,data} @see @ref overview_printing, wxPrintDialog, @ref overview_cmndlg_print */ class wxPrintDialogData : public wxObject { public: /** Default constructor. */ wxPrintDialogData(); /** Copy constructor. */ wxPrintDialogData(const wxPrintDialogData& dialogData); /** Construct an object from a print dialog data object. */ wxPrintDialogData(const wxPrintData& printData); /** Destructor. */ virtual ~wxPrintDialogData(); /** Enables or disables the "Help" button. */ void EnableHelp(bool flag); /** Enables or disables the "Page numbers" controls. */ void EnablePageNumbers(bool flag); /** Enables or disables the "Print to file" checkbox. */ void EnablePrintToFile(bool flag); /** Enables or disables the "Selection" radio button. */ void EnableSelection(bool flag); /** Allows or disallows selecting printing the "Current Page" in the dialog. This currently only has an effect under MSW, where the native dialog enables the "Current Page" radio button if this function is called to allow the user to print the current page only. @since 3.3.0 */ void EnableCurrentPage(bool flag); /** Returns @true if the user requested that all pages be printed. */ bool GetAllPages() const; /** Returns @true if the user requested that the document(s) be collated. */ bool GetCollate() const; /** Returns the @e from page number, as entered by the user. This function can't be used if multiple page ranges were specified, use GetPageRanges() instead. */ int GetFromPage() const; /** Returns the @e maximum page number. */ int GetMaxPage() const; /** Returns the @e minimum page number. */ int GetMinPage() const; /** Returns the number of copies requested by the user. */ int GetNoCopies() const; /** Returns a reference to the internal wxPrintData object. */ wxPrintData& GetPrintData(); /** Returns @true if the user has selected printing to a file. */ bool GetPrintToFile() const; /** Returns @true if the user requested that the selection be printed (where "selection" is a concept specific to the application). */ bool GetSelection() const; /** Returns @true if the user requested that the current page be printed. Note that the "current page" is defined by the application. It only makes sense to call this function if EnableCurrentPage() had been called before, otherwise it always returns @false. @since 3.3.0 */ bool GetCurrentPage() const; /** Returns @true if the user requested printing only the specified pages. The pages to print can be retrieved using GetPageRanges(). @since 3.3.0 */ bool GetSpecifiedPages() const; /** Returns the @e "print to" page number, as entered by the user. This function can't be used if multiple page ranges were specified, use GetPageRanges() instead. */ int GetToPage() const; /** Returns @true if the print data is valid for using in print dialogs. This can return @false on Windows if the current printer is not set, for example. On all other platforms, it returns @true. */ bool IsOk() const; /** Selects the "All pages" radio button. When called with @true value, enables printing all pages. This is the default behaviour. If @a flag is @false, this function doesn't do anything unless it had been called with @true value before and in this case it switches to printing the selected pages only (see GetSpecifiedPages()). */ void SetAllPages(bool flag = true); /** Sets the "Collate" checkbox to @true or @false. */ void SetCollate(bool flag); /** Sets the @e from page number. Together with SetToPage(), this function can be used to define a single range of pages to print. If you need to specify multiple ranges, use SetPageRanges() instead. @note If SetPageRanges() was used to specify multiple ranges, this function cannot be used as there is no single "from" page to set. */ void SetFromPage(int page); /** Sets the @e maximum page number. */ void SetMaxPage(int page); /** Sets the @e minimum page number. */ void SetMinPage(int page); /** Sets the default number of copies the user has requested to be printed out. */ void SetNoCopies(int n); /** Sets the internal wxPrintData. */ void SetPrintData(const wxPrintData& printData); /** Sets the "Print to file" checkbox to @true or @false. */ void SetPrintToFile(bool flag); /** Selects the "Selection" radio button. The effect of printing the selection depends on how the application implements this command, if at all. This function should only be called when EnableSelection() is used as well. If @a flag is @false, this function doesn't do anything unless it had been called with @true value before and in this case it switches to printing the selected pages only (see GetSpecifiedPages()). */ void SetSelection(bool flag = true); /** Selects the "Current Page" radio button when the dialog is initially shown. This function can only be called when EnableCurrentPage() is used as well. If @a flag is @false, this function doesn't do anything unless it had been called with @true value before and in this case it switches to printing the selected pages only (see GetSpecifiedPages()). @see GetCurrentPage() @since 3.3.0 */ void SetCurrentPage(bool flag = true); /** @deprecated This function has been deprecated since version 2.5.4. Determines whether the dialog to be shown will be the Print dialog (pass @false) or Print Setup dialog (pass @true). */ void SetSetupDialog(bool flag); /** Sets the @e "print to" page number. Together with SetFromPage(), this function can be used to define a single range of pages to print. If you need to specify multiple ranges, use SetPageRanges() instead. @note If SetPageRanges() was used to specify multiple ranges, this function cannot be used as there is no single "to" page to set. */ void SetToPage(int page); /** Assigns print data to this object. */ void operator =(const wxPrintData& data); /** Assigns another print dialog data object to this object. */ void operator =(const wxPrintDialogData& data); /** Sets the maximum number of page ranges that the user can specify. This value is used as a limit for the number of page ranges that can be used in the print dialog. The default value is 64. Currently this is only used in wxMSW. @since 3.3.0 */ void SetMaxPageRanges(int maxRanges); /** Returns the maximum number of page ranges that the user can specify. @see SetMaxRanges() @since 3.3.0 */ int GetMaxPageRanges() const; /** Returns the page ranges to print. This vector contains the page ranges to be printed. If it is empty, all pages are printed, otherwise only the pages in the specified ranges are. @see SetPageRanges() @since 3.3.0 */ const std::vector& GetPageRanges() const; /** Sets the ranges of pages to print. Each element of the vector represents a range of pages to print. All ranges should be disjoint and be specified in increasing order. Currently only wxMSW supports the full functionality of this function, all other ports only allow specifying a single range. Passing an empty vector is equivalent to printing all pages. @since 3.3.0 */ void SetPageRanges(const std::vector& pageRanges); };