Newer
Older
powermon_manager_sw / lib / wxWidgets / include / wx / cmndata.h
@Razvan Turiac Razvan Turiac 7 hours ago 13 KB ...
/////////////////////////////////////////////////////////////////////////////
// Name:        wx/cmndata.h
// Purpose:     Common GDI data classes
// Author:      Julian Smart and others
// Created:     01/02/97
// Copyright:   (c)
// Licence:     wxWindows licence
/////////////////////////////////////////////////////////////////////////////

#ifndef _WX_CMNDATA_H_BASE_
#define _WX_CMNDATA_H_BASE_

#include "wx/defs.h"

#if wxUSE_PRINTING_ARCHITECTURE

#include "wx/gdicmn.h"

#if wxUSE_STREAMS
#include "wx/stream.h"
#endif

#include <vector>

class WXDLLIMPEXP_FWD_CORE wxPrintNativeDataBase;

/*
 * wxPrintData
 * Encapsulates printer information (not printer dialog information)
 */

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
};

const int wxPRINTMEDIA_DEFAULT = 0;

class WXDLLIMPEXP_CORE wxPrintData: public wxObject
{
public:
    wxPrintData();
    wxPrintData(const wxPrintData& printData);
    virtual ~wxPrintData();

    int GetNoCopies() const { return m_printNoCopies; }
    bool GetCollate() const { return m_printCollate; }
    wxPrintOrientation GetOrientation() const { return m_printOrientation; }
    bool IsOrientationReversed() const { return m_printOrientationReversed; }

    // Is this data OK for showing the print dialog?
    bool Ok() const { return IsOk(); }
    bool IsOk() const ;

    const wxString& GetPrinterName() const { return m_printerName; }
    bool GetColour() const { return m_colour; }
    wxDuplexMode GetDuplex() const { return m_duplexMode; }
    wxPaperSize GetPaperId() const { return m_paperId; }
    const wxSize& GetPaperSize() const { return m_paperSize; }
    wxPrintQuality GetQuality() const { return m_printQuality; }
    wxPrintBin GetBin() const { return m_bin; }
    wxPrintMode GetPrintMode() const { return m_printMode; }
    int GetMedia() const { return m_media; }

    void SetNoCopies(int v) { m_printNoCopies = v; }
    void SetCollate(bool flag) { m_printCollate = flag; }

    // Please use the overloaded method below
    wxDEPRECATED_INLINE(void SetOrientation(int orient),
                        m_printOrientation = (wxPrintOrientation)orient; )
    void SetOrientation(wxPrintOrientation orient) { m_printOrientation = orient; }
    void SetOrientationReversed(bool reversed) { m_printOrientationReversed = reversed; }

    void SetPrinterName(const wxString& name) { m_printerName = name; }
    void SetColour(bool colour) { m_colour = colour; }
    void SetDuplex(wxDuplexMode duplex) { m_duplexMode = duplex; }
    void SetPaperId(wxPaperSize sizeId) { m_paperId = sizeId; }
    void SetPaperSize(const wxSize& sz) { m_paperSize = sz; }
    void SetQuality(wxPrintQuality quality) { m_printQuality = quality; }
    void SetBin(wxPrintBin bin) { m_bin = bin; }
    void SetMedia(int media) { m_media = media; }
    void SetPrintMode(wxPrintMode printMode) { m_printMode = printMode; }

    wxString GetFilename() const { return m_filename; }
    void SetFilename( const wxString &filename ) { m_filename = filename; }

    wxPrintData& operator=(const wxPrintData& data);

    char* GetPrivData() { return m_privData.empty() ? nullptr : &m_privData[0]; }
    const char* GetPrivData() const { return m_privData.empty() ? nullptr : &m_privData[0]; }
    int GetPrivDataLen() const { return wxSsize(m_privData); }
    void SetPrivData( char *privData, int len );


    // Convert between wxPrintData and native data
    void ConvertToNative();
    void ConvertFromNative();
    // Holds the native print data
    wxPrintNativeDataBase *GetNativeData() const { return m_nativeData.get(); }

private:
    wxPrintBin      m_bin = wxPRINTBIN_DEFAULT;
    int             m_media = wxPRINTMEDIA_DEFAULT;
    wxPrintMode     m_printMode = wxPRINT_MODE_PRINTER;

    int             m_printNoCopies = 1;
    wxPrintOrientation m_printOrientation = wxPORTRAIT;
    bool            m_printOrientationReversed = false;
    bool            m_printCollate = false;

    wxString        m_printerName;
    bool            m_colour = true;
    wxDuplexMode    m_duplexMode = wxDUPLEX_SIMPLEX;
    wxPrintQuality  m_printQuality = wxPRINT_QUALITY_HIGH;

    // we intentionally don't initialize paper id and size at all, like this
    // the default system settings will be used for them
    wxPaperSize     m_paperId = wxPAPER_NONE;
    wxSize          m_paperSize = wxDefaultSize;

    wxString        m_filename;

    std::vector<char> m_privData;

    wxObjectDataPtr<wxPrintNativeDataBase> m_nativeData;

private:
    wxDECLARE_DYNAMIC_CLASS(wxPrintData);
};

/*
 * wxPrintPageRange
 * Defines a range of pages to be printed.
 */

class wxPrintPageRange
{
public:
    wxPrintPageRange() = default;
    wxPrintPageRange(int from, int to) : fromPage(from), toPage(to)
    {
        wxASSERT_MSG( IsValid(), "Invalid page range values" );
    }

    // check if both components are set/initialized correctly
    bool IsValid() const { return fromPage > 0 && fromPage <= toPage; }

    // get the number of pages in the range
    int GetNumberOfPages() const { return toPage - fromPage + 1; }

    int fromPage = 0;
    int toPage = 0;
};

using wxPrintPageRanges = std::vector<wxPrintPageRange>;

/*
 * wxPrintDialogData
 * Encapsulates information displayed and edited in the printer dialog box.
 * Contains a wxPrintData object which is filled in according to the values retrieved
 * from the dialog.
 */

class WXDLLIMPEXP_CORE wxPrintDialogData: public wxObject
{
public:
    wxPrintDialogData();
    wxPrintDialogData(const wxPrintDialogData& dialogData) = default;
    wxPrintDialogData(const wxPrintData& printData);
    virtual ~wxPrintDialogData();

    // These functions can be used only when printing all pages or a single
    // continuous range of pages, use GetPageRanges() to support multiple
    // ranges.
    int GetFromPage() const;
    int GetToPage() const;

    int GetMinPage() const { return m_printMinPage; }
    int GetMaxPage() const { return m_printMaxPage; }
    int GetNoCopies() const { return m_printNoCopies; }
    bool GetAllPages() const { return m_printWhat == Print::AllPages; }
    bool GetSelection() const { return m_printWhat == Print::Selection; }
    bool GetCurrentPage() const { return m_printWhat == Print::CurrentPage; }
    bool GetSpecifiedPages() const { return m_printWhat == Print::SpecifiedPages; }
    bool GetCollate() const { return m_printCollate; }
    bool GetPrintToFile() const { return m_printToFile; }

    // Similarly to the getters above, these functions can be used only to
    // define a single continuous range of pages to print, use SetPageRanges()
    // for anything else. Note that if you do use SetPageRanges() to specify
    // multiple ranges, then these functions cannot be used.
    void SetFromPage(int v);
    void SetToPage(int v);

    void SetMinPage(int v) { m_printMinPage = v; }
    void SetMaxPage(int v) { m_printMaxPage = v; }
    void SetNoCopies(int v) { m_printNoCopies = v; }

    // Avoid calling these functions with flag == false as it's not really
    // obvious what they do in this case.
    void SetAllPages(bool flag = true) { DoSetWhat(Print::AllPages, flag); }
    void SetSelection(bool flag = true) { DoSetWhat(Print::Selection, flag); }
    void SetCurrentPage(bool flag = true) { DoSetWhat(Print::CurrentPage, flag); }

    void SetCollate(bool flag) { m_printCollate = flag; }
    void SetPrintToFile(bool flag) { m_printToFile = flag; }

    void EnablePrintToFile(bool flag) { m_printEnablePrintToFile = flag; }
    void EnableSelection(bool flag) { m_printEnableSelection = flag; }
    void EnableCurrentPage(bool flag) { m_printEnableCurrentPage = flag; }
    void EnablePageNumbers(bool flag) { m_printEnablePageNumbers = flag; }
    void EnableHelp(bool flag) { m_printEnableHelp = flag; }

    bool GetEnablePrintToFile() const { return m_printEnablePrintToFile; }
    bool GetEnableSelection() const { return m_printEnableSelection; }
    bool GetEnableCurrentPage() const { return m_printEnableCurrentPage; }
    bool GetEnablePageNumbers() const { return m_printEnablePageNumbers; }
    bool GetEnableHelp() const { return m_printEnableHelp; }

    // Is this data OK for showing the print dialog?
    bool Ok() const { return IsOk(); }
    bool IsOk() const { return m_printData.IsOk() ; }

    wxPrintData& GetPrintData() { return m_printData; }
    void SetPrintData(const wxPrintData& printData) { m_printData = printData; }

    void SetPageRanges(const wxPrintPageRanges& pageRanges) { m_printPageRanges = pageRanges; }
    const wxPrintPageRanges& GetPageRanges() const { return m_printPageRanges; }

    void SetMaxPageRanges(int maxPageRanges) { m_maxPageRanges = maxPageRanges; }
    int GetMaxPageRanges() const { return m_maxPageRanges; }

    wxPrintDialogData& operator=(const wxPrintDialogData& data) = default;
    void operator=(const wxPrintData& data); // Sets internal m_printData member

private:
    enum class Print
    {
        SpecifiedPages, // Default used if none of the other flags are selected.
        AllPages,
        Selection,
        CurrentPage
    };

    void DoSetWhat(Print what, bool flag);

    Print           m_printWhat = Print::AllPages;

    int             m_printMinPage = 0;
    int             m_printMaxPage = 0;
    int             m_printNoCopies = 1;

    bool            m_printCollate = false;
    bool            m_printToFile = false;
    bool            m_printEnableSelection = false;
    bool            m_printEnableCurrentPage = false;
    bool            m_printEnablePageNumbers = true;
    bool            m_printEnableHelp = false;
    bool            m_printEnablePrintToFile = true;
    wxPrintData     m_printData;

    // Maximum number of page ranges that the user can specify via the print dialog.
    int m_maxPageRanges = 64;

    // The page ranges to print. If this vector contains more then m_maxPageRanges
    // elements, then the maximum number of page ranges that the user can specify
    // via the print dialog is the size of this vector.
    wxPrintPageRanges m_printPageRanges;

private:
    wxDECLARE_DYNAMIC_CLASS(wxPrintDialogData);
};

/*
* This is the data used (and returned) by the wxPageSetupDialog.
*/

// Compatibility with old name
#define wxPageSetupData wxPageSetupDialogData

class WXDLLIMPEXP_CORE wxPageSetupDialogData: public wxObject
{
public:
    wxPageSetupDialogData();
    wxPageSetupDialogData(const wxPageSetupDialogData& dialogData) = default;
    wxPageSetupDialogData(const wxPrintData& printData);

    wxSize GetPaperSize() const { return m_paperSize; }
    wxPaperSize GetPaperId() const { return m_printData.GetPaperId(); }
    wxPoint GetMinMarginTopLeft() const { return m_minMarginTopLeft; }
    wxPoint GetMinMarginBottomRight() const { return m_minMarginBottomRight; }
    wxPoint GetMarginTopLeft() const { return m_marginTopLeft; }
    wxPoint GetMarginBottomRight() const { return m_marginBottomRight; }

    bool GetDefaultMinMargins() const { return m_defaultMinMargins; }
    bool GetEnableMargins() const { return m_enableMargins; }
    bool GetEnableOrientation() const { return m_enableOrientation; }
    bool GetEnablePaper() const { return m_enablePaper; }
    bool GetEnablePrinter() const { return m_enablePrinter; }
    bool GetDefaultInfo() const { return m_getDefaultInfo; }
    bool GetEnableHelp() const { return m_enableHelp; }

    // Is this data OK for showing the page setup dialog?
    bool Ok() const { return IsOk(); }
    bool IsOk() const { return m_printData.IsOk() ; }

    // If a corresponding paper type is found in the paper database, will set the m_printData
    // paper size id member as well.
    void SetPaperSize(const wxSize& sz);

    void SetPaperId(wxPaperSize id) { m_printData.SetPaperId(id); }

    // Sets the wxPrintData id, plus the paper width/height if found in the paper database.
    void SetPaperSize(wxPaperSize id);

    void SetMinMarginTopLeft(const wxPoint& pt) { m_minMarginTopLeft = pt; }
    void SetMinMarginBottomRight(const wxPoint& pt) { m_minMarginBottomRight = pt; }
    void SetMarginTopLeft(const wxPoint& pt) { m_marginTopLeft = pt; }
    void SetMarginBottomRight(const wxPoint& pt) { m_marginBottomRight = pt; }
    void SetDefaultMinMargins(bool flag) { m_defaultMinMargins = flag; }
    void SetDefaultInfo(bool flag) { m_getDefaultInfo = flag; }

    void EnableMargins(bool flag) { m_enableMargins = flag; }
    void EnableOrientation(bool flag) { m_enableOrientation = flag; }
    void EnablePaper(bool flag) { m_enablePaper = flag; }
    void EnablePrinter(bool flag) { m_enablePrinter = flag; }
    void EnableHelp(bool flag) { m_enableHelp = flag; }

    // Use paper size defined in this object to set the wxPrintData
    // paper id
    void CalculateIdFromPaperSize();

    // Use paper id in wxPrintData to set this object's paper size
    void CalculatePaperSizeFromId();

    wxPageSetupDialogData& operator=(const wxPageSetupDialogData& data) = default;
    wxPageSetupDialogData& operator=(const wxPrintData& data);

    wxPrintData& GetPrintData() { return m_printData; }
    const wxPrintData& GetPrintData() const { return m_printData; }
    void SetPrintData(const wxPrintData& printData);

private:
    wxSize          m_paperSize; // The dimensions selected by the user (on return, same as in wxPrintData?)
    wxPoint         m_minMarginTopLeft;
    wxPoint         m_minMarginBottomRight;
    wxPoint         m_marginTopLeft;
    wxPoint         m_marginBottomRight;
    bool            m_defaultMinMargins = false;
    bool            m_enableMargins = true;
    bool            m_enableOrientation = true;
    bool            m_enablePaper = true;
    bool            m_enablePrinter = true;
    bool            m_getDefaultInfo = false; // Equiv. to PSD_RETURNDEFAULT
    bool            m_enableHelp = false;
    wxPrintData     m_printData;

private:
    wxDECLARE_DYNAMIC_CLASS(wxPageSetupDialogData);
};

#endif // wxUSE_PRINTING_ARCHITECTURE

#endif
// _WX_CMNDATA_H_BASE_