no need to export private list/arrays of generic controls' implementations

[wxWidgets.git] / interface / palette.h

diff --git a/interface/palette.h b/interface/palette.h
index 0249292ab5f7e6908f14881cf8fcaf5a298c192f..6c8d61c460a7e3040495b957dd70fedc7d03c6ac 100644 (file)
--- a/interface/palette.h
+++ b/interface/palette.h
@@ -1,6 +1,6 @@
 /////////////////////////////////////////////////////////////////////////////
 // Name:        palette.h
-// Purpose:     documentation for wxPalette class
+// Purpose:     interface of wxPalette
 // Author:      wxWidgets team
 // RCS-ID:      $Id$
 // Licence:     wxWindows license
@@ -27,11 +27,9 @@
     @category{gdi}
 
     @stdobjects
-    Objects:
-    wxNullPalette
+    ::Objects:, ::wxNullPalette,
 
-    @seealso
-    wxDC::SetPalette, wxBitmap
+    @see wxDC::SetPalette, wxBitmap
 */
 class wxPalette : public wxGDIObject
 {
@@ -40,23 +38,19 @@ public:
     /**
         Creates a palette from arrays of size @e n, one for each
         red, blue or green component.
-        
+
         @param palette
-        A pointer or reference to the palette to copy.
-        
+            A pointer or reference to the palette to copy.
         @param n
-        The number of indices in the palette.
-        
+            The number of indices in the palette.
         @param red
-        An array of red values.
-        
+            An array of red values.
         @param green
-        An array of green values.
-        
+            An array of green values.
         @param blue
-        An array of blue values.
-        
-        @sa Create()
+            An array of blue values.
+
+        @see Create()
     */
     wxPalette();
     wxPalette(const wxPalette& palette);
@@ -75,22 +69,19 @@ public:
     /**
         Creates a palette from arrays of size @e n, one for each
         red, blue or green component.
-        
+
         @param n
-        The number of indices in the palette.
-        
+            The number of indices in the palette.
         @param red
-        An array of red values.
-        
+            An array of red values.
         @param green
-        An array of green values.
-        
+            An array of green values.
         @param blue
-        An array of blue values.
-        
+            An array of blue values.
+
         @returns @true if the creation was successful, @false otherwise.
-        
-        @sa wxPalette()
+
+        @see wxPalette()
     */
     bool Create(int n, const unsigned char* red,
                 const unsigned char* green,
@@ -99,57 +90,66 @@ public:
     /**
         Returns number of entries in palette.
     */
-    int GetColoursCount();
+    int GetColoursCount() const;
 
     /**
         Returns a pixel value (index into the palette) for the given RGB values.
-        
+
         @param red
-        Red value.
-        
+            Red value.
         @param green
-        Green value.
-        
+            Green value.
         @param blue
-        Blue value.
-        
+            Blue value.
+
         @returns The nearest palette index or wxNOT_FOUND for unexpected errors.
-        
-        @sa GetRGB()
+
+        @see GetRGB()
     */
     int GetPixel(unsigned char red, unsigned char green,
-                 unsigned char blue);
+                 unsigned char blue) const;
 
     /**
         Returns RGB values for a given palette index.
-        
+
         @param pixel
-        The palette index.
-        
+            The palette index.
         @param red
-        Receives the red value.
-        
+            Receives the red value.
         @param green
-        Receives the green value.
-        
+            Receives the green value.
         @param blue
-        Receives the blue value.
-        
+            Receives the blue value.
+
         @returns @true if the operation was successful.
-        
-        @sa GetPixel()
+
+        @see GetPixel()
     */
-#define bool GetRGB(int pixel, const unsigned char* red,
-    const unsigned char* green,
-    const unsigned char* blue)     /* implementation is private */
+    bool GetRGB(int pixel, const unsigned char* red,
+                const unsigned char* green,
+                const unsigned char* blue) const;
 
     /**
         Returns @true if palette data is present.
     */
-#define bool IsOk()     /* implementation is private */
+    bool IsOk() const;
 
     /**
         Assignment operator, using @ref overview_trefcount "reference counting".
     */
     wxPalette operator =(const wxPalette& palette);
 };
+
+
+/**
+    FIXME
+*/
+wxPalette Objects:
+;
+
+/**
+    FIXME
+*/
+wxPalette wxNullPalette;
+
+