X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/1f1d2182ffe4feb82a1e674266f47d172ed3cb3c..d095f867de4d7c00fe9996f714892141d917f308:/interface/choice.h

diff --git a/interface/choice.h b/interface/choice.h
index 48ff01128a..db7d1c10bf 100644
--- a/interface/choice.h
+++ b/interface/choice.h
@@ -11,29 +11,36 @@
     @wxheader{choice.h}
 
     A choice item is used to select one of a list of strings. Unlike a
-    listbox, only the selection is visible until the user pulls down the
+    wxListBox, only the selection is visible until the user pulls down the
     menu of choices.
 
     @beginStyleTable
-    @style{wxCB_SORT}:
+    @style{wxCB_SORT}
            Sorts the entries alphabetically.
     @endStyleTable
 
     @beginEventTable{wxCommandEvent}
-    @event{EVT_CHOICE(id, func)}:
+    @event{EVT_CHOICE(id, func)}
            Process a wxEVT_COMMAND_CHOICE_SELECTED event, when an item on the
            list is selected.
     @endEventTable
 
     @library{wxcore}
     @category{ctrl}
-    @appearance{choice.png}
+    <!-- @appearance{choice.png} -->
 
     @see wxListBox, wxComboBox, wxCommandEvent
 */
 class wxChoice : public wxControlWithItems
 {
 public:
+    /**
+        Default constructor.
+
+        @see Create(), wxValidator
+    */
+    wxChoice();
+
     //@{
     /**
         Constructor, creating and showing a choice.
@@ -45,8 +52,7 @@ public:
         @param pos
             Window position.
         @param size
-            Window size. If wxDefaultSize is specified then the choice is
-        sized
+            Window size. If wxDefaultSize is specified then the choice is sized
             appropriately.
         @param n
             Number of strings with which to initialise the choice control.
@@ -60,8 +66,14 @@ public:
             Window name.
 
         @see Create(), wxValidator
+
+        @beginWxPythonOnly
+
+        The wxChoice constructor in wxPython reduces the @a n and @a choices
+        arguments to a single argument, which is a list of strings.
+
+        @endWxPythonOnly
     */
-    wxChoice();
     wxChoice(wxWindow* parent, wxWindowID id,
              const wxPoint& pos,
              const wxSize& size, int n,
@@ -105,22 +117,22 @@ public:
     /**
         Gets the number of columns in this choice item.
 
-        @remarks This is implemented for Motif only and always returns 1 for the
-                 other platforms.
+        @remarks This is implemented for Motif only and always returns 1 for
+                 the other platforms.
     */
     int GetColumns() const;
 
     /**
-        Unlike wxControlWithItems::GetSelection which only
-        returns the accepted selection value, i.e. the selection in the control once
-        the user closes the dropdown list, this function returns the current selection.
-        That is, while the dropdown list is shown, it returns the currently selected
-        item in it. When it is not shown, its result is the same as for the other
-        function.
-
-        @wxsince{2.6.2} (before this version
-        wxControlWithItems::GetSelection itself behaved like
-        this).
+        Unlike wxControlWithItems::GetSelection() which only returns the
+        accepted selection value, i.e. the selection in the control once the
+        user closes the dropdown list, this function returns the current
+        selection. That is, while the dropdown list is shown, it returns the
+        currently selected item in it. When it is not shown, its result is the
+        same as for the other function.
+
+        @since 2.6.2.
+               In older versions, wxControlWithItems::GetSelection() itself
+               behaved like this.
     */
     int GetCurrentSelection() const;
 
@@ -129,6 +141,9 @@ public:
 
         @param n
             Number of columns.
+
+        @remarks This is implemented for Motif only and doesn’t do anything
+                 under other platforms.
     */
     void SetColumns(int n = 1);
 };