X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/23324ae1c7938ba904770fc456d3c07764b9c5e9..bddd07670f86fcfd1419bac3785a18829900f163:/interface/colordlg.h diff --git a/interface/colordlg.h b/interface/colordlg.h index cdf5cfae1e..41233fb1bc 100644 --- a/interface/colordlg.h +++ b/interface/colordlg.h @@ -1,6 +1,6 @@ ///////////////////////////////////////////////////////////////////////////// // Name: colordlg.h -// Purpose: documentation for wxColourDialog class +// Purpose: interface of wxColourDialog // Author: wxWidgets team // RCS-ID: $Id$ // Licence: wxWindows license @@ -9,15 +9,14 @@ /** @class wxColourDialog @wxheader{colordlg.h} - + This class represents the colour chooser dialog. - + @library{wxcore} @category{cmndlg} - - @seealso - @ref overview_wxcolourdialogoverview "wxColourDialog Overview", wxColour, - wxColourData, wxGetColourFromUser + + @see @ref overview_wxcolourdialogoverview "wxColourDialog Overview", wxColour, + wxColourData, wxGetColourFromUser() */ class wxColourDialog : public wxDialog { @@ -29,10 +28,10 @@ public: Invalid entries in custom colours list will be ignored on some platforms (GTK) or replaced with white colour on platforms where custom colours palette has fixed size (MSW). - - @sa wxColourData + + @see wxColourData */ - wxColourDialog(wxWindow* parent, wxColourData* data = @NULL); + wxColourDialog(wxWindow* parent, wxColourData* data = NULL); /** Destructor. @@ -42,7 +41,7 @@ public: /** Same as @ref ctor() constructor. */ - bool Create(wxWindow* parent, wxColourData* data = @NULL); + bool Create(wxWindow* parent, wxColourData* data = NULL); /** Returns the @ref overview_wxcolourdata "colour data" associated with the colour @@ -58,31 +57,36 @@ public: }; + // ============================================================================ // Global functions/macros // ============================================================================ +/** @ingroup group_funcmacro_dialog */ +//@{ + /** - Shows the colour selection dialog and returns the colour selected by user or - invalid colour (use @ref wxColour::isok wxColour:IsOk to test whether a colour - is valid) if the dialog was cancelled. - - @param parent - The parent window for the colour selection dialog - - @param colInit - If given, this will be the colour initially selected in the dialog. - - @param caption - If given, this will be used for the dialog caption. - - @param data - Optional object storing additional colour dialog settings, such - as custom colours. If none is provided the same settings as the last time are - used. + Shows the colour selection dialog and returns the colour selected by user + or invalid colour (use wxColour::IsOk() to test whether a colour is valid) + if the dialog was cancelled. + + @param parent + The parent window for the colour selection dialog. + @param colInit + If given, this will be the colour initially selected in the dialog. + @param caption + If given, this will be used for the dialog caption. + @param data + Optional object storing additional colour dialog settings, such as + custom colours. If none is provided the same settings as the last time + are used. + + @header{wx/colordlg.h} */ -wxColour wxGetColourFromUser(wxWindow * parent, +wxColour wxGetColourFromUser(wxWindow* parent, const wxColour& colInit, const wxString& caption = wxEmptyString, - wxColourData * data = @NULL); + wxColourData* data = NULL); + +//@}