/////////////////////////////////////////////////////////////////////////////
// Name: cmndata.h
-// Purpose: interface of common wx*Data classes (font, colour, print)
+// Purpose: interface of print wx*Data classes
// Author: wxWidgets team
// RCS-ID: $Id$
-// Licence: wxWindows license
+// Licence: wxWindows licence
/////////////////////////////////////////////////////////////////////////////
-/**
- @class wxFontData
-
- This class holds a variety of information related to font dialogs.
-
- @library{wxcore}
- @category{cmndlg}
-
- @see @ref overview_cmndlg_font, wxFont, wxFontDialog
-*/
-class wxFontData : public wxObject
-{
-public:
- /**
- Constructor. Initializes @e fontColour to black, @e showHelp to @false,
- @e allowSymbols to @true, @e enableEffects to @true, @e minSize to 0
- and @e maxSize to 0.
- */
- wxFontData();
-
- /**
- Enables or disables "effects" under Windows or generic only. This
- refers to the controls for manipulating colour, strikeout and underline
- properties.
-
- The default value is @true.
- */
- void EnableEffects(bool enable);
-
- /**
- Under Windows, returns a flag determining whether symbol fonts can be
- selected. Has no effect on other platforms.
-
- The default value is @true.
- */
- bool GetAllowSymbols() const;
-
- /**
- Gets the font chosen by the user if the user pressed OK
- (wxFontDialog::ShowModal() returned wxID_OK).
- */
- wxFont GetChosenFont() const;
-
- /**
- Gets the colour associated with the font dialog.
-
- The default value is black.
- */
- wxColour& GetColour();
-
- /**
- Determines whether "effects" are enabled under Windows. This refers to
- the controls for manipulating colour, strikeout and underline
- properties.
-
- The default value is @true.
- */
- bool GetEnableEffects() const;
-
- /**
- Gets the font that will be initially used by the font dialog. This
- should have previously been set by the application.
- */
- wxFont GetInitialFont() const;
-
- /**
- Returns @true if the Help button will be shown (Windows only).
-
- The default value is @false.
- */
- bool GetShowHelp() const;
-
- /**
- Under Windows, determines whether symbol fonts can be selected. Has no
- effect on other platforms.
-
- The default value is @true.
- */
- void SetAllowSymbols(bool allowSymbols);
-
- /**
- Sets the font that will be returned to the user (for internal use
- only).
- */
- void SetChosenFont(const wxFont& font);
-
- /**
- Sets the colour that will be used for the font foreground colour.
-
- The default colour is black.
- */
- void SetColour(const wxColour& colour);
-
- /**
- Sets the font that will be initially used by the font dialog.
- */
- void SetInitialFont(const wxFont& font);
-
- /**
- Sets the valid range for the font point size (Windows only).
-
- The default is 0, 0 (unrestricted range).
- */
- void SetRange(int min, int max);
-
- /**
- Determines whether the Help button will be displayed in the font dialog
- (Windows only).
-
- The default value is @false.
- */
- void SetShowHelp(bool showHelp);
-
- /**
- Assignment operator for the font data.
- */
- void operator =(const wxFontData& data);
-};
-
-
-
/**
@class wxPageSetupDialogData
stored by wxPageSetupDialogData).
@library{wxcore}
- @category{printing}
+ @category{printing,data}
@see @ref overview_printing, wxPageSetupDialog
*/
/**
Copy constructor.
*/
- wxPageSetupDialogData(wxPageSetupDialogData& data);
+ wxPageSetupDialogData(const wxPageSetupDialogData& data);
/**
Construct an object from a print data object.
*/
- wxPageSetupDialogData(wxPrintData& printData);
+ wxPageSetupDialogData(const wxPrintData& printData);
/**
Destructor.
/**
Returns a reference to the print data associated with this object.
*/
- wxPrintData GetPrintData();
+ wxPrintData& GetPrintData();
+ const wxPrintData& GetPrintData() const;
/**
Returns @true if the print data associated with the dialog data is
@see wxPrintData::SetPaperId()
*/
- void SetPaperId(wxPaperSize& id);
+ void SetPaperId(wxPaperSize id);
/**
Sets the paper size in millimetres. If a corresponding paper id is
/**
Assigns print data to this object.
*/
- void operator =(const wxPrintData& data);
+ wxPageSetupDialogData& operator =(const wxPrintData& data);
/**
Assigns page setup data to this object.
*/
- void operator =(const wxPageSetupDialogData& data);
+ wxPageSetupDialogData& operator =(const wxPageSetupDialogData& data);
};
-
-
-/**
- @class wxColourData
-
- This class holds a variety of information related to colour dialogs.
-
- @library{wxcore}
- @category{cmndlg}
-
- @see wxColour, wxColourDialog, @ref overview_cmndlg_colour
-*/
-class wxColourData : public wxObject
-{
-public:
- /**
- Constructor. Initializes the custom colours to @c wxNullColour, the
- @e data colour setting to black, and the @e choose full setting to
- @true.
- */
- wxColourData();
-
- /**
- Destructor.
- */
- virtual ~wxColourData();
-
- /**
- Under Windows, determines whether the Windows colour dialog will
- display the full dialog with custom colour selection controls. Under
- PalmOS, determines whether colour dialog will display full rgb colour
- picker or only available palette indexer. Has no meaning under other
- platforms.
-
- The default value is @true.
- */
- bool GetChooseFull() const;
-
- /**
- Gets the current colour associated with the colour dialog.
-
- The default colour is black.
- */
- wxColour& GetColour();
-
- /**
- Returns custom colours associated with the colour dialog.
-
- @param i
- An integer between 0 and 15, being any of the 15 custom colours
- that the user has saved. The default custom colours are invalid
- colours.
- */
- wxColour GetCustomColour(int i) const;
-
- /**
- Under Windows, tells the Windows colour dialog to display the full
- dialog with custom colour selection controls. Under other platforms,
- has no effect.
-
- The default value is @true.
- */
- void SetChooseFull(const bool flag);
-
- /**
- Sets the default colour for the colour dialog.
-
- The default colour is black.
- */
- void SetColour(const wxColour& colour);
-
- /**
- Sets custom colours for the colour dialog.
-
- @param i
- An integer between 0 and 15 for whatever custom colour you want to
- set. The default custom colours are invalid colours.
- */
- void SetCustomColour(int i, const wxColour& colour);
-
- /**
- Assignment operator for the colour data.
- */
- void operator =(const wxColourData& data);
-
-
- /** @todo document these */
- wxString wxColourData::ToString() const;
- bool wxColourData::FromString(const wxString& str);
-};
-
-
-
/**
Enumeration of various printer bin sources.
@endcode
@library{wxcore}
- @category{printing}
+ @category{printing,data}
@see @ref overview_printing, wxPrintDialog, wxPageSetupDialog,
wxPrintDialogData, wxPageSetupDialogData, @ref overview_cmndlg_print,
/**
Gets the orientation. This can be wxLANDSCAPE or wxPORTRAIT.
*/
- int GetOrientation() const;
+ wxPrintOrientation GetOrientation() const;
/**
Returns the paper size id.
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;
+ const wxString& GetPrinterName() const;
/**
Returns the current print quality. This can be a positive integer,
/**
Sets the orientation. This can be wxLANDSCAPE or wxPORTRAIT.
*/
- void SetOrientation(int orientation);
+ void SetOrientation(wxPrintOrientation orientation);
/**
Sets the paper id. This indicates the type of paper to be used. For a
/**
Assigns print data to this object.
*/
- void operator =(const wxPrintData& data);
+ wxPrintData& operator =(const wxPrintData& data);
};
settings.
@library{wxcore}
- @category{printing}
+ @category{printing,cmndlg,data}
@see @ref overview_printing, wxPrintDialog, @ref overview_cmndlg_print
*/
/**
Copy constructor.
*/
- wxPrintDialogData(wxPrintDialogData& dialogData);
+ wxPrintDialogData(const wxPrintDialogData& dialogData);
/**
Construct an object from a print dialog data object.
*/
- wxPrintDialogData(wxPrintData& printData);
+ wxPrintDialogData(const wxPrintData& printData);
/**
Destructor.
projects / wxWidgets.git / blobdiff