clear up wxStringBuffer docs a bit

[wxWidgets.git] / include / wx / os2 / colour.h

diff --git a/include/wx/os2/colour.h b/include/wx/os2/colour.h
index 24028b6756baf4926821d96666acaa1ccc8a9062..889a8ef798de35e833b743dcfd3fd9a3fea4aa3c 100644 (file)
--- a/include/wx/os2/colour.h
+++ b/include/wx/os2/colour.h
@@ -1,97 +1,125 @@
 /////////////////////////////////////////////////////////////////////////////
 // Name:        colour.h
 // Purpose:     wxColour class
-// Author:      AUTHOR
+// Author:      David Webster
 // Modified by:
-// Created:     ??/??/98
+// Created:     10/13/99
 // RCS-ID:      $Id$
-// Copyright:   (c) AUTHOR
+// Copyright:   (c) David Webster
 // Licence:     wxWindows licence
 /////////////////////////////////////////////////////////////////////////////
 
 #ifndef _WX_COLOUR_H_
 #define _WX_COLOUR_H_
 
-#ifdef __GNUG__
-#pragma interface "colour.h"
-#endif
-
 #include "wx/object.h"
-#include "wx/string.h"
 
 // Colour
 class WXDLLEXPORT wxColour: public wxObject
 {
 public:
-  // ctors
-    // default
-  wxColour();
-    // from RGB
-  wxColour( unsigned char red, unsigned char green, unsigned char blue );
-    // implicit conversion from the colour name
-  wxColour( const wxString &colourName ) { InitFromName(colourName); }
-  wxColour( const char *colourName ) { InitFromName(colourName); }
-
-    // copy ctors and assignment operators
-  wxColour( const wxColour& col );
-  wxColour( const wxColour* col );
-  wxColour& operator = ( const wxColour& col );
-
-    // dtor
-  ~wxColour();
-
-  // Set() functions
-  void Set( unsigned char red, unsigned char green, unsigned char blue );
-  void Set( unsigned long colRGB )
-  {
-    // we don't need to know sizeof(long) here because we assume that the three
-    // least significant bytes contain the R, G and B values
-    Set((unsigned char)colRGB,
-        (unsigned char)(colRGB >> 8),
-        (unsigned char)(colRGB >> 16));
-  }
-
-  // accessors
-  bool Ok() const {return m_isInit; }
-
-  // Let's remove this inelegant function
-#if WXWIN_COMPATIBILITY
-  void Get(unsigned char *r, unsigned char *g, unsigned char *b) const;
-#endif
+    //
+    // Ctors
+    //
 
-  unsigned char Red() const { return m_red; }
-  unsigned char Green() const { return m_green; }
-  unsigned char Blue() const { return m_blue; }
+    //
+    // Default
+    //
+    wxColour();
 
-  // comparison
-  bool operator == (const wxColour& colour) const
-  {
-    return (m_red == colour.m_red && 
-            m_green == colour.m_green && 
-            m_blue == colour.m_blue);
-  }
-  bool operator != (const wxColour& colour) const { return !(*this == colour); }
+    //
+    // from RGB
+    //
+    wxColour( unsigned char cRed
+             ,unsigned char cGreen
+             ,unsigned char cBlue
+            );
+
+    wxColour( unsigned long colRGB ) { Set(colRGB); }
+
+    //
+    // Implicit conversion from the colour name
+    //
+    wxColour(const wxString& rColourName) { InitFromName(rColourName); }
+    wxColour(const wxChar *zColourName) { InitFromName(zColourName); }
+
+    //
+    // Copy ctors and assignment operators
+    //
+    wxColour(const wxColour& rCol);
+    wxColour(const wxColour* pCol);
+    wxColour&operator = (const wxColour& rCol);
+
+    //
+    // Dtor
+    //
+    ~wxColour();
+
+    //
+    // Set functions
+    //
+    void Set( unsigned char cRed
+             ,unsigned char cGreen
+             ,unsigned char cBlue
+            );
+    void Set(unsigned long lColRGB)
+    {
+        //
+        // We don't need to know sizeof(long) here because we assume that the three
+        // least significant bytes contain the R, G and B values
+        //
+        Set( (unsigned char)lColRGB
+            ,(unsigned char)(lColRGB >> 8)
+            ,(unsigned char)(lColRGB >> 16)
+           );
+    }
+    void Set(const wxString& rsColour)
+    {
+        InitFromName(rsColour);
+    }
+
+    //
+    // Accessors
+    //
+    bool Ok(void) const {return m_bIsInit; }
+
+    unsigned char Red(void) const { return m_cRed; }
+    unsigned char Green(void) const { return m_cGreen; }
+    unsigned char Blue(void) const { return m_cBlue; }
+
+    //
+    // Comparison
+    //
+    bool operator == (const wxColour& rColour) const
+    {
+        return (m_bIsInit == rColour.m_bIsInit
+                && m_cRed   == rColour.m_cRed
+                && m_cGreen == rColour.m_cGreen
+                && m_cBlue  == rColour.m_cBlue
+               );
+    }
+
+    bool operator != (const wxColour& rColour) const { return !(*this == rColour); }
+
+    WXCOLORREF GetPixel(void) const { return m_vPixel; };
+
+    void InitFromName(const wxString& rCol);
 
-  void InitFromName(const wxString& col);
+private:
 
-/* TODO
-  WXCOLORREF GetPixel() const { return m_pixel; };
-*/
+    // Helper function
+    void Init();
 
-private:
-  bool          m_isInit;
-  unsigned char m_red;
-  unsigned char m_blue;
-  unsigned char m_green;
+    bool                            m_bIsInit;
+    unsigned char                   m_cRed;
+    unsigned char                   m_cBlue;
+    unsigned char                   m_cGreen;
 
 public:
-  /* TODO: implementation
-     WXCOLORREF m_pixel ;
-   */
-
+    WXCOLORREF                      m_vPixel ;
 private:
   DECLARE_DYNAMIC_CLASS(wxColour)
-};
+}; // end of class wxColour
 
 #endif
   // _WX_COLOUR_H_