X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/12f5e1e78fe906050ff2fee9529476db332633f0..c29c95fe24973b94fd724db767193171ca7c513d:/interface/wx/fontdlg.h diff --git a/interface/wx/fontdlg.h b/interface/wx/fontdlg.h index 8afae325e8..bd0d404ce6 100644 --- a/interface/wx/fontdlg.h +++ b/interface/wx/fontdlg.h @@ -3,7 +3,7 @@ // Purpose: interface of wxFontDialog // Author: wxWidgets team // RCS-ID: $Id$ -// Licence: wxWindows license +// Licence: wxWindows licence ///////////////////////////////////////////////////////////////////////////// /** @@ -14,49 +14,63 @@ @library{wxcore} @category{cmndlg} - @see Overview(), wxFontData, wxGetFontFromUser() + @see overview_cmndlg_font, wxFontData, wxGetFontFromUser() */ class wxFontDialog : public wxDialog { public: - //@{ /** - Constructor. Pass a parent window, and optionally the - @ref overview_wxfontdata "font data" object to be used to initialize the dialog - controls. If the default constructor is used, - Create() must be called before the dialog can be - shown. + Default ctor. + Create() must be called before the dialog can be shown. */ wxFontDialog(); + + /** + Constructor with parent window. + */ wxFontDialog(wxWindow* parent); + + /** + Constructor. + Pass a parent window, and the @ref wxFontData "font data" object + to be used to initialize the dialog controls. + */ wxFontDialog(wxWindow* parent, const wxFontData& data); - //@} - //@{ /** - Creates the dialog if it the wxFontDialog object had been initialized using the - default constructor. Returns @true on success and @false if an error - occurred. + Creates the dialog if the wxFontDialog object had been initialized using + the default constructor. + + @return @true on success and @false if an error occurred. */ bool Create(wxWindow* parent); + + /** + Creates the dialog if the wxFontDialog object had been initialized using + the default constructor. + + @return @true on success and @false if an error occurred. + */ bool Create(wxWindow* parent, const wxFontData& data); - //@} //@{ /** - Returns the @ref overview_wxfontdata "font data" associated with the font - dialog. + Returns the @ref wxFontData "font data" associated with the + font dialog. */ - const wxFontData GetFontData(); - const wxFontData& GetFontData(); + const wxFontData& GetFontData() const; + wxFontData& GetFontData(); //@} /** Shows the dialog, returning @c wxID_OK if the user pressed Ok, and @c wxID_CANCEL otherwise. + If the user cancels the dialog (ShowModal returns @c wxID_CANCEL), no font will be created. If the user presses OK, a new wxFont will be created and stored in the font dialog's wxFontData structure. + + @see GetFontData() */ int ShowModal(); }; @@ -67,7 +81,7 @@ public: // Global functions/macros // ============================================================================ -/** @ingroup group_funcmacro_dialog */ +/** @addtogroup group_funcmacro_dialog */ //@{ /**