/////////////////////////////////////////////////////////////////////////////
// Name: colordlg.h
-// Purpose: documentation for wxColourDialog class
+// Purpose: interface of wxColourDialog
// Author: wxWidgets team
// RCS-ID: $Id$
// Licence: wxWindows license
/**
@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
{
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.
/**
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
};
+
// ============================================================================
// 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);
+
+//@}