From 4608b3f83757f5eac74f7113cf99ab42887ce0b9 Mon Sep 17 00:00:00 2001 From: Paul Cornett Date: Sat, 8 Jan 2011 06:57:23 +0000 Subject: [PATCH] update docs after r66615 git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@66649 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775 --- interface/wx/cmndata.h | 225 +------------------------------------- interface/wx/colourdata.h | 105 ++++++++++++++++++ interface/wx/fontdata.h | 126 +++++++++++++++++++++ 3 files changed, 232 insertions(+), 224 deletions(-) create mode 100644 interface/wx/colourdata.h create mode 100644 interface/wx/fontdata.h diff --git a/interface/wx/cmndata.h b/interface/wx/cmndata.h index ab0492c72d..eb43b0056b 100644 --- a/interface/wx/cmndata.h +++ b/interface/wx/cmndata.h @@ -1,132 +1,11 @@ ///////////////////////////////////////////////////////////////////////////// // 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 licence ///////////////////////////////////////////////////////////////////////////// -/** - @class wxFontData - - This class holds a variety of information related to font dialogs. - - @library{wxcore} - @category{cmndlg,data} - - @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. - */ - const wxColour& GetColour() const; - - /** - 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. - */ - wxFontData& operator =(const wxFontData& data); -}; - - - /** @class wxPageSetupDialogData @@ -341,108 +220,6 @@ public: wxPageSetupDialogData& operator =(const wxPageSetupDialogData& data); }; - - -/** - @class wxColourData - - This class holds a variety of information related to colour dialogs. - - @library{wxcore} - @category{cmndlg,data} - - @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(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. - @param colour - The colour to set - */ - void SetCustomColour(int i, const wxColour& colour); - - /** - Converts the colours saved in this class in a string form, separing - the various colours with a comma. - */ - wxString ToString() const; - - /** - Decodes the given string, which should be in the same format returned - by ToString(), and sets the internal colours. - */ - bool FromString(const wxString& str); - - /** - Assignment operator for the colour data. - */ - wxColourData& operator =(const wxColourData& data); -}; - - - /** Enumeration of various printer bin sources. diff --git a/interface/wx/colourdata.h b/interface/wx/colourdata.h new file mode 100644 index 0000000000..45b5aab175 --- /dev/null +++ b/interface/wx/colourdata.h @@ -0,0 +1,105 @@ +///////////////////////////////////////////////////////////////////////////// +// Name: colourdata.h +// Purpose: interface of wxColourData +// Author: wxWidgets team +// RCS-ID: $Id$ +// Licence: wxWindows licence +///////////////////////////////////////////////////////////////////////////// + +/** + @class wxColourData + + This class holds a variety of information related to colour dialogs. + + @library{wxcore} + @category{cmndlg,data} + + @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(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. + @param colour + The colour to set + */ + void SetCustomColour(int i, const wxColour& colour); + + /** + Converts the colours saved in this class in a string form, separing + the various colours with a comma. + */ + wxString ToString() const; + + /** + Decodes the given string, which should be in the same format returned + by ToString(), and sets the internal colours. + */ + bool FromString(const wxString& str); + + /** + Assignment operator for the colour data. + */ + wxColourData& operator =(const wxColourData& data); +}; diff --git a/interface/wx/fontdata.h b/interface/wx/fontdata.h new file mode 100644 index 0000000000..fb46ff14ba --- /dev/null +++ b/interface/wx/fontdata.h @@ -0,0 +1,126 @@ +///////////////////////////////////////////////////////////////////////////// +// Name: fontdata.h +// Purpose: interface of wxFontData +// Author: wxWidgets team +// RCS-ID: $Id$ +// Licence: wxWindows licence +///////////////////////////////////////////////////////////////////////////// + +/** + @class wxFontData + + This class holds a variety of information related to font dialogs. + + @library{wxcore} + @category{cmndlg,data} + + @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. + */ + const wxColour& GetColour() const; + + /** + 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. + */ + wxFontData& operator =(const wxFontData& data); +}; -- 2.45.2