Implement HasSelection for the OSX WebKit backend.

[wxWidgets.git] / include / wx / ctrlsub.h

diff --git a/include/wx/ctrlsub.h b/include/wx/ctrlsub.h
index 0393859bb508b71e714fa0ecbae260fd24ea6b84..82a98dfdfb835f9b1d39cc0a768aa9b8fca3c512 100644 (file)
--- a/include/wx/ctrlsub.h
+++ b/include/wx/ctrlsub.h
@@ -30,7 +30,7 @@
 // implements an extended interface deriving from this one)
 // ----------------------------------------------------------------------------
 
 // implements an extended interface deriving from this one)
 // ----------------------------------------------------------------------------
 

-class WXDLLEXPORT wxItemContainerImmutable
+class WXDLLIMPEXP_CORE wxItemContainerImmutable

 {
 public:
     wxItemContainerImmutable() { }
 {
 public:
     wxItemContainerImmutable() { }


@@ -73,7 +73,7 @@ public:
     bool SetStringSelection(const wxString& s);
 
     // return the selected string or empty string if none
     bool SetStringSelection(const wxString& s);
 
     // return the selected string or empty string if none

-    wxString GetStringSelection() const;
+    virtual wxString GetStringSelection() const;

 
     // this is the same as SetSelection( for single-selection controls but
     // reads better for multi-selection ones
 
     // this is the same as SetSelection( for single-selection controls but
     // reads better for multi-selection ones


@@ -97,7 +97,7 @@ protected:
 // in this case DoInsertItem() needs to be overridden.
 // ----------------------------------------------------------------------------
 
 // in this case DoInsertItem() needs to be overridden.
 // ----------------------------------------------------------------------------
 

-class WXDLLEXPORT wxItemContainer : public wxItemContainerImmutable
+class WXDLLIMPEXP_CORE wxItemContainer : public wxItemContainerImmutable

 {
 private:
     // AppendItems() and InsertItems() helpers just call DoAppend/InsertItems()
 {
 private:
     // AppendItems() and InsertItems() helpers just call DoAppend/InsertItems()


@@ -121,8 +121,8 @@ private:
 
     int AppendItems(const wxArrayStringsAdapter& items, void **clientData)
     {
 
     int AppendItems(const wxArrayStringsAdapter& items, void **clientData)
     {

-        wxASSERT_MSG( m_clientDataItemsType != wxClientData_Object,
-                      _T("can't mix different types of client data") );
+        wxASSERT_MSG( GetClientDataType() != wxClientData_Object,
+                      wxT("can't mix different types of client data") );

 
         return AppendItems(items, clientData, wxClientData_Void);
     }
 
         return AppendItems(items, clientData, wxClientData_Void);
     }


@@ -130,10 +130,10 @@ private:
     int AppendItems(const wxArrayStringsAdapter& items,
                     wxClientData **clientData)
     {
     int AppendItems(const wxArrayStringsAdapter& items,
                     wxClientData **clientData)
     {

-        wxASSERT_MSG( m_clientDataItemsType != wxClientData_Void,
-                      _T("can't mix different types of client data") );
+        wxASSERT_MSG( GetClientDataType() != wxClientData_Void,
+                      wxT("can't mix different types of client data") );

 
 

-        return AppendItems(items, wx_reinterpret_cast(void **, clientData),
+        return AppendItems(items, reinterpret_cast<void **>(clientData),

                            wxClientData_Object);
     }
 
                            wxClientData_Object);
     }
 


@@ -142,17 +142,17 @@ private:
                     void **clientData,
                     wxClientDataType type)
     {
                     void **clientData,
                     wxClientDataType type)
     {

-        wxASSERT_MSG( !IsSorted(), _T("can't insert items in sorted control") );
+        wxASSERT_MSG( !IsSorted(), wxT("can't insert items in sorted control") );

 
         wxCHECK_MSG( pos <= GetCount(), wxNOT_FOUND,
 
         wxCHECK_MSG( pos <= GetCount(), wxNOT_FOUND,

-                     _T("position out of range") );
+                     wxT("position out of range") );

 
         // not all derived classes handle empty arrays correctly in
         // DoInsertItems() and besides it really doesn't make much sense to do
         // this (for append it could correspond to creating an initially empty
         // control but why would anybody need to insert 0 items?)
         wxCHECK_MSG( !items.IsEmpty(), wxNOT_FOUND,
 
         // not all derived classes handle empty arrays correctly in
         // DoInsertItems() and besides it really doesn't make much sense to do
         // this (for append it could correspond to creating an initially empty
         // control but why would anybody need to insert 0 items?)
         wxCHECK_MSG( !items.IsEmpty(), wxNOT_FOUND,

-                     _T("need something to insert") );
+                     wxT("need something to insert") );

 
         return DoInsertItems(items, pos, clientData, type);
     }
 
         return DoInsertItems(items, pos, clientData, type);
     }


@@ -166,8 +166,8 @@ private:
                      unsigned int pos,
                      void **clientData)
     {
                      unsigned int pos,
                      void **clientData)
     {

-        wxASSERT_MSG( m_clientDataItemsType != wxClientData_Object,
-                      _T("can't mix different types of client data") );
+        wxASSERT_MSG( GetClientDataType() != wxClientData_Object,
+                      wxT("can't mix different types of client data") );

 
         return InsertItems(items, pos, clientData, wxClientData_Void);
     }
 
         return InsertItems(items, pos, clientData, wxClientData_Void);
     }


@@ -176,11 +176,11 @@ private:
                      unsigned int pos,
                      wxClientData **clientData)
     {
                      unsigned int pos,
                      wxClientData **clientData)
     {

-        wxASSERT_MSG( m_clientDataItemsType != wxClientData_Void,
-                      _T("can't mix different types of client data") );
+        wxASSERT_MSG( GetClientDataType() != wxClientData_Void,
+                      wxT("can't mix different types of client data") );

 
         return InsertItems(items, pos,
 
         return InsertItems(items, pos,

-                           wx_reinterpret_cast(void **, clientData),
+                           reinterpret_cast<void **>(clientData),

                            wxClientData_Object);
     }
 
                            wxClientData_Object);
     }
 


@@ -280,28 +280,47 @@ public:
     void Delete(unsigned int pos);
 
 
     void Delete(unsigned int pos);
 
 

+    // various accessors
+    // -----------------
+
+    // The control may maintain its items in a sorted order in which case
+    // items are automatically inserted at the right position when they are
+    // inserted or appended. Derived classes have to override this method if
+    // they implement sorting, typically by returning HasFlag(wxXX_SORT)
+    virtual bool IsSorted() const { return false; }
+
+

     // client data stuff
     // -----------------
 
     void SetClientData(unsigned int n, void* clientData);
     void* GetClientData(unsigned int n) const;
 
     // client data stuff
     // -----------------
 
     void SetClientData(unsigned int n, void* clientData);
     void* GetClientData(unsigned int n) const;
 

+    // SetClientObject() takes ownership of the pointer, GetClientObject()
+    // returns it but keeps the ownership while DetachClientObject() expects
+    // the caller to delete the pointer and also resets the internally stored
+    // one to NULL for this item

     void SetClientObject(unsigned int n, wxClientData* clientData);
     wxClientData* GetClientObject(unsigned int n) const;
     void SetClientObject(unsigned int n, wxClientData* clientData);
     wxClientData* GetClientObject(unsigned int n) const;

+    wxClientData* DetachClientObject(unsigned int n);
+
+    // return the type of client data stored in this control: usually it just
+    // returns m_clientDataItemsType but must be overridden in the controls
+    // which delegate their client data storage to another one (e.g. wxChoice
+    // in wxUniv which stores data in wxListBox which it uses anyhow); don't
+    // forget to override SetClientDataType() if you override this one
+    //
+    // NB: for this to work no code should ever access m_clientDataItemsType
+    //     directly but only via this function!
+    virtual wxClientDataType GetClientDataType() const
+        { return m_clientDataItemsType; }

 
     bool HasClientData() const
 
     bool HasClientData() const

-        { return m_clientDataItemsType != wxClientData_None; }
+        { return GetClientDataType() != wxClientData_None; }

     bool HasClientObjectData() const
     bool HasClientObjectData() const

-        { return m_clientDataItemsType == wxClientData_Object; }
+        { return GetClientDataType() == wxClientData_Object; }

     bool HasClientUntypedData() const
     bool HasClientUntypedData() const

-        { return m_clientDataItemsType == wxClientData_Void; }
-
-
-    // The control may maintain its items in a sorted order in which case
-    // items are automatically inserted at the right position when they are
-    // inserted or appended. Derived classes have to override this method if
-    // they implement sorting, typically by returning HasFlag(wxXX_SORT)
-    virtual bool IsSorted() const { return false; }
+        { return GetClientDataType() == wxClientData_Void; }

 
 protected:
     // there is usually no need to override this method but you can do it if it
 
 protected:
     // there is usually no need to override this method but you can do it if it


@@ -364,7 +383,14 @@ protected:
     // set it to NULL (must only be called if HasClientObjectData())
     void ResetItemClientObject(unsigned int n);
 
     // set it to NULL (must only be called if HasClientObjectData())
     void ResetItemClientObject(unsigned int n);
 

+    // set the type of the client data stored in this control: override this if
+    // you override GetClientDataType()
+    virtual void SetClientDataType(wxClientDataType clientDataItemsType)
+    {
+        m_clientDataItemsType = clientDataItemsType;
+    }

 
 

+private:

     // the type of the client data for the items
     wxClientDataType m_clientDataItemsType;
 };
     // the type of the client data for the items
     wxClientDataType m_clientDataItemsType;
 };


@@ -391,7 +417,7 @@ protected:
     wxClientData* GetClientObject(unsigned int n) const                    \
         { return wxItemContainer::GetClientObject(n); }
 
     wxClientData* GetClientObject(unsigned int n) const                    \
         { return wxItemContainer::GetClientObject(n); }
 

-class WXDLLEXPORT wxControlWithItemsBase : public wxControl,
+class WXDLLIMPEXP_CORE wxControlWithItemsBase : public wxControl,

                                            public wxItemContainer
 {
 public:
                                            public wxItemContainer
 {
 public:


@@ -416,7 +442,7 @@ protected:
     void InitCommandEventWithItems(wxCommandEvent& event, int n);
 
 private:
     void InitCommandEventWithItems(wxCommandEvent& event, int n);
 
 private:

-    DECLARE_NO_COPY_CLASS(wxControlWithItemsBase)
+    wxDECLARE_NO_COPY_CLASS(wxControlWithItemsBase);

 };
 
 // define the platform-specific wxControlWithItems class
 };
 
 // define the platform-specific wxControlWithItems class


@@ -425,14 +451,14 @@ private:
 #elif defined(__WXMOTIF__)
     #include "wx/motif/ctrlsub.h"
 #else
 #elif defined(__WXMOTIF__)
     #include "wx/motif/ctrlsub.h"
 #else

-    class WXDLLEXPORT wxControlWithItems : public wxControlWithItemsBase
+    class WXDLLIMPEXP_CORE wxControlWithItems : public wxControlWithItemsBase

     {
     public:
         wxControlWithItems() { }
 
     private:
         DECLARE_ABSTRACT_CLASS(wxControlWithItems)
     {
     public:
         wxControlWithItems() { }
 
     private:
         DECLARE_ABSTRACT_CLASS(wxControlWithItems)

-        DECLARE_NO_COPY_CLASS(wxControlWithItems)
+        wxDECLARE_NO_COPY_CLASS(wxControlWithItems);

     };
 #endif
 
     };
 #endif