no real changes, clarified the usage of WX_GL_DOUBLEBUFFER; documented it and other...

[wxWidgets.git] / interface / editlbox.h

diff --git a/interface/editlbox.h b/interface/editlbox.h
index 9f62c0cd8f94f7fc858d37566f5406d283ae2876..ae0dcb2c221361bc341876c9729428fa0b2ade75 100644 (file)
--- a/interface/editlbox.h
+++ b/interface/editlbox.h
@@ -1,6 +1,6 @@
 /////////////////////////////////////////////////////////////////////////////
 // Name:        editlbox.h
-// Purpose:     documentation for wxEditableListBox class
+// Purpose:     interface of wxEditableListBox
 // Author:      wxWidgets team
 // RCS-ID:      $Id$
 // Licence:     wxWindows license
@@ -9,68 +9,63 @@
 /**
     @class wxEditableListBox
     @wxheader{editlbox.h}
-    
-    An editable listbox is composite control that lets the
-    user easily enter, delete and reorder a list of strings.
-    
+
+    An editable listbox is composite control that lets the user easily enter,
+    delete and reorder a list of strings.
+
     @beginStyleTable
-    @style{wxEL_ALLOW_NEW}:
+    @style{wxEL_ALLOW_NEW}
            Allows the user to enter new strings.
-    @style{wxEL_ALLOW_EDIT}:
+    @style{wxEL_ALLOW_EDIT}
            Allows the user to edit existing strings.
-    @style{wxEL_ALLOW_DELETE}:
+    @style{wxEL_ALLOW_DELETE}
            Allows the user to delete existing strings.
-    @style{wxEL_NO_REORDER}:
+    @style{wxEL_NO_REORDER}
            Does not allow the user to reorder the strings.
-    @style{wxEL_DEFAULT_STYLE}:
-           wxEL_ALLOW_NEW|wxEL_ALLOW_EDIT|wxEL_ALLOW_DELETE
+    @style{wxEL_DEFAULT_STYLE}
+           Default style: wxEL_ALLOW_NEW|wxEL_ALLOW_EDIT|wxEL_ALLOW_DELETE.
     @endStyleTable
-    
+
     @library{wxadv}
-    @category{FIXME}
-    
-    @seealso
-    wxListBox
+    @category{ctrl}
+
+    @see wxListBox
 */
 class wxEditableListBox : public wxPanel
 {
 public:
-    //@{
     /**
-        Constructor, creating and showing a list box.
-        
-        @param parent 
-        Parent window. Must not be @NULL.
-        
-        @param id 
-        Window identifier. The value wxID_ANY indicates a default value.
-        
-        @param label 
-        The text shown just before the list control.
-        
-        @param pos 
-        Window position.
-        
-        @param size 
-        Window size. If wxDefaultSize is specified then the window is sized
-        appropriately.
-        
-        @param style 
-        Window style. See wxEditableListBox.
-        
-        @param name 
-        Window name.
-        
-        @sa Create()
+        Default ctor.
     */
     wxEditableListBox();
-        wxEditableListBox(wxWindow* parent, wxWindowID id,
-                          const wxString& label,
-                          const wxPoint& pos = wxDefaultPosition,
-                          const wxSize& size = wxDefaultSize,
-                          long style = wxEL_DEFAULT_STYLE,
-                          const wxString& name = "editableListBox");
-    //@}
+
+    /**
+        Constructor, creating and showing a list box.
+
+        @param parent
+            Parent window. Must not be @NULL.
+        @param id
+            Window identifier. The value wxID_ANY indicates a default value.
+        @param label
+            The text shown just before the list control.
+        @param pos
+            Window position.
+        @param size
+            Window size. If wxDefaultSize is specified then the window is sized
+            appropriately.
+        @param style
+            Window style. See wxEditableListBox.
+        @param name
+            Window name.
+
+        @see Create()
+    */
+    wxEditableListBox(wxWindow* parent, wxWindowID id,
+                      const wxString& label,
+                      const wxPoint& pos = wxDefaultPosition,
+                      const wxSize& size = wxDefaultSize,
+                      long style = wxEL_DEFAULT_STYLE,
+                      const wxString& name = "editableListBox");
 
     /**
         Destructor, destroying the list box.
@@ -78,8 +73,8 @@ public:
     ~wxEditableListBox();
 
     /**
-        Creates the editable listbox for two-step construction. See wxEditableListBox()
-        for further details.
+        Creates the editable listbox for two-step construction.
+        See wxEditableListBox() for further details.
     */
     bool Create(wxWindow* parent, wxWindowID id,
                 const wxString& label,
@@ -92,4 +87,12 @@ public:
         Replaces current contents with given strings.
     */
     void SetStrings(const wxArrayString& strings);
+
+
+    /**
+        Returns in the given array the current contents of the control
+        (the array will be erased before control's contents are appended).
+    */
+    void GetSelections(wxArrayString& strings) const;
 };
+