don't disable hidden windows in wxWindowDisabler, it's at best useless

[wxWidgets.git] / include / wx / htmllbox.h
diff --git a/include/wx/htmllbox.h b/include/wx/htmllbox.h

index c3764c399d8297b35771067cc67339559f84b537..97f2ae413edae12f43b86f44e60572b4f8266aa2 100644 (file)
--- a/include/wx/htmllbox.h
+++ b/include/wx/htmllbox.h
@@ -17,6 +17,7 @@
  class WXDLLEXPORT wxHtmlCell;
  class WXDLLEXPORT wxHtmlWinParser;
  class WXDLLEXPORT wxHtmlListBoxCache;
  class WXDLLEXPORT wxHtmlCell;
  class WXDLLEXPORT wxHtmlWinParser;
  class WXDLLEXPORT wxHtmlListBoxCache;
+class WXDLLEXPORT wxHtmlListBoxStyle;
  
  // ----------------------------------------------------------------------------
  // wxHtmlListBox
  
  // ----------------------------------------------------------------------------
  // wxHtmlListBox
@@ -36,32 +37,34 @@ public:
                    wxWindowID id = wxID_ANY,
                    const wxPoint& pos = wxDefaultPosition,
                    const wxSize& size = wxDefaultSize,
                    wxWindowID id = wxID_ANY,
                    const wxPoint& pos = wxDefaultPosition,
                    const wxSize& size = wxDefaultSize,
-                  size_t countItems = 0,
                    long style = 0,
                    const wxString& name = wxVListBoxNameStr)
      {
          Init();
  
                    long style = 0,
                    const wxString& name = wxVListBoxNameStr)
      {
          Init();
  
-        (void)Create(parent, id, pos, size, countItems, style, name);
+        (void)Create(parent, id, pos, size, style, name);
      }
  
      // really creates the control and sets the initial number of items in it
      // (which may be changed later with SetItemCount())
      //
      }
  
      // really creates the control and sets the initial number of items in it
      // (which may be changed later with SetItemCount())
      //
-    // there are no special styles defined for wxVListBox
+    // the only special style which may be specified here is wxLB_MULTIPLE
      //
      // returns true on success or false if the control couldn't be created
      bool Create(wxWindow *parent,
                  wxWindowID id = wxID_ANY,
                  const wxPoint& pos = wxDefaultPosition,
                  const wxSize& size = wxDefaultSize,
      //
      // returns true on success or false if the control couldn't be created
      bool Create(wxWindow *parent,
                  wxWindowID id = wxID_ANY,
                  const wxPoint& pos = wxDefaultPosition,
                  const wxSize& size = wxDefaultSize,
-                size_t countItems = 0,
                  long style = 0,
                  const wxString& name = wxVListBoxNameStr);
  
      // destructor cleans up whatever resources we use
      virtual ~wxHtmlListBox();
  
                  long style = 0,
                  const wxString& name = wxVListBoxNameStr);
  
      // destructor cleans up whatever resources we use
      virtual ~wxHtmlListBox();
  
+    // refresh everything
+    virtual void RefreshAll();
+
+
  protected:
      // this method must be implemented in the derived class and should return
      // the body (i.e. without <html>) of the HTML for the given item
  protected:
      // this method must be implemented in the derived class and should return
      // the body (i.e. without <html>) of the HTML for the given item
@@ -71,12 +74,30 @@ protected:
      virtual wxString OnGetItemMarkup(size_t n) const;
  
  
      virtual wxString OnGetItemMarkup(size_t n) const;
  
  
+    // this method allows to customize the selection appearance: it may be used
+    // to specify the colour of the text which normally has the given colour
+    // colFg when it is inside the selection
+    //
+    // by default, the original colour is not used at all and all text has the
+    // same (default for this system) colour inside selection
+    virtual wxColour GetSelectedTextColour(const wxColour& colFg) const;
+
+    // this is the same as GetSelectedTextColour() but allows to customize the
+    // background colour -- this is even more rarely used as you can change it
+    // globally using SetSelectionBackground()
+    virtual wxColour GetSelectedTextBgColour(const wxColour& colBg) const;
+
+
      // we implement both of these functions in terms of OnGetItem(), they are
      // not supposed to be overridden by our descendants
      virtual void OnDrawItem(wxDC& dc, const wxRect& rect, size_t n) const;
      virtual wxCoord OnMeasureItem(size_t n) const;
  
  
      // we implement both of these functions in terms of OnGetItem(), they are
      // not supposed to be overridden by our descendants
      virtual void OnDrawItem(wxDC& dc, const wxRect& rect, size_t n) const;
      virtual wxCoord OnMeasureItem(size_t n) const;
  
  
+    // event handlers
+    void OnSize(wxSizeEvent& event);
+
+
      // common part of all ctors
      void Init();
  
      // common part of all ctors
      void Init();
  
@@ -84,10 +105,21 @@ protected:
      void CacheItem(size_t n) const;
  
  private:
      void CacheItem(size_t n) const;
  
  private:
+    // this class caches the pre-parsed HTML to speed up display
      wxHtmlListBoxCache *m_cache;
  
      // HTML parser we use
      wxHtmlWinParser *m_htmlParser;
      wxHtmlListBoxCache *m_cache;
  
      // HTML parser we use
      wxHtmlWinParser *m_htmlParser;
+
+    // rendering style for the parser which allows us to customize our colours
+    wxHtmlListBoxStyle *m_htmlRendStyle;
+
+
+    // it calls our GetSelectedTextColour() and GetSelectedTextBgColour()
+    friend class wxHtmlListBoxStyle;
+
+
+    DECLARE_EVENT_TABLE()
  };
  
  #endif // _WX_HTMLLBOX_H_
  };
  
  #endif // _WX_HTMLLBOX_H_