Correct wxID_SEPARATOR description in menu documentation.

[wxWidgets.git] / interface / wx / listctrl.h

diff --git a/interface/wx/listctrl.h b/interface/wx/listctrl.h
index fa380eeb01cd0c73f266dcf2c8e24009cfdb408e..5b50f9853793277d3e1680bbec527f46ae6e7222 100644 (file)
--- a/interface/wx/listctrl.h
+++ b/interface/wx/listctrl.h
@@ -86,44 +86,65 @@
     @beginEventEmissionTable{wxListEvent}
     @event{EVT_LIST_BEGIN_DRAG(id, func)}
            Begin dragging with the left mouse button.
     @beginEventEmissionTable{wxListEvent}
     @event{EVT_LIST_BEGIN_DRAG(id, func)}
            Begin dragging with the left mouse button.

+          Processes a @c wxEVT_COMMAND_LIST_BEGIN_DRAG event type.

     @event{EVT_LIST_BEGIN_RDRAG(id, func)}
     @event{EVT_LIST_BEGIN_RDRAG(id, func)}

-           Begin dragging with the right mouse button..
-    @event{EVT_LIST_BEGIN_LABEL_EDIT(id, func)}
+           Begin dragging with the right mouse button.
+           Processes a @c wxEVT_COMMAND_LIST_BEGIN_RDRAG event type.
+    @event{EVT_BEGIN_LABEL_EDIT(id, func)}

            Begin editing a label. This can be prevented by calling Veto().
            Begin editing a label. This can be prevented by calling Veto().

+           Processes a @c wxEVT_COMMAND_LIST_BEGIN_LABEL_EDIT event type.

     @event{EVT_LIST_END_LABEL_EDIT(id, func)}
            Finish editing a label. This can be prevented by calling Veto().
     @event{EVT_LIST_END_LABEL_EDIT(id, func)}
            Finish editing a label. This can be prevented by calling Veto().

+           Processes a @c wxEVT_COMMAND_LIST_END_LABEL_EDIT event type.

     @event{EVT_LIST_DELETE_ITEM(id, func)}
            An item was deleted.
     @event{EVT_LIST_DELETE_ITEM(id, func)}
            An item was deleted.

+           Processes a @c wxEVT_COMMAND_LIST_DELETE_ITEM event type.

     @event{EVT_LIST_DELETE_ALL_ITEMS(id, func)}
            All items were deleted.
     @event{EVT_LIST_DELETE_ALL_ITEMS(id, func)}
            All items were deleted.

+           Processes a @c wxEVT_COMMAND_LIST_DELETE_ALL_ITEMS event type.

     @event{EVT_LIST_ITEM_SELECTED(id, func)}
            The item has been selected.
     @event{EVT_LIST_ITEM_SELECTED(id, func)}
            The item has been selected.

+           Processes a @c wxEVT_COMMAND_LIST_ITEM_SELECTED event type.

     @event{EVT_LIST_ITEM_DESELECTED(id, func)}
            The item has been deselected.
     @event{EVT_LIST_ITEM_DESELECTED(id, func)}
            The item has been deselected.

+           Processes a @c wxEVT_COMMAND_LIST_ITEM_DESELECTED event type.

     @event{EVT_LIST_ITEM_ACTIVATED(id, func)}
            The item has been activated (ENTER or double click).
     @event{EVT_LIST_ITEM_ACTIVATED(id, func)}
            The item has been activated (ENTER or double click).

+           Processes a @c wxEVT_COMMAND_LIST_ITEM_ACTIVATED event type.

     @event{EVT_LIST_ITEM_FOCUSED(id, func)}
            The currently focused item has changed.
     @event{EVT_LIST_ITEM_FOCUSED(id, func)}
            The currently focused item has changed.

+           Processes a @c wxEVT_COMMAND_LIST_ITEM_FOCUSED event type.

     @event{EVT_LIST_ITEM_MIDDLE_CLICK(id, func)}
     @event{EVT_LIST_ITEM_MIDDLE_CLICK(id, func)}

-           The middle mouse button has been clicked on an item.
+           The middle mouse button has been clicked on an item. This is
+           only supported by the generic control.
+           Processes a @c wxEVT_COMMAND_LIST_ITEM_MIDDLE_CLICK event type.

     @event{EVT_LIST_ITEM_RIGHT_CLICK(id, func)}
           The right mouse button has been clicked on an item.
     @event{EVT_LIST_ITEM_RIGHT_CLICK(id, func)}
           The right mouse button has been clicked on an item.

+          Processes a @c wxEVT_COMMAND_LIST_ITEM_RIGHT_CLICK event type.

     @event{EVT_LIST_KEY_DOWN(id, func)}
            A key has been pressed.
     @event{EVT_LIST_KEY_DOWN(id, func)}
            A key has been pressed.

+           Processes a @c wxEVT_COMMAND_LIST_KEY_DOWN event type.

     @event{EVT_LIST_INSERT_ITEM(id, func)}
            An item has been inserted.
     @event{EVT_LIST_INSERT_ITEM(id, func)}
            An item has been inserted.

+           Processes a @c wxEVT_COMMAND_LIST_INSERT_ITEM event type.

     @event{EVT_LIST_COL_CLICK(id, func)}
            A column (m_col) has been left-clicked.
     @event{EVT_LIST_COL_CLICK(id, func)}
            A column (m_col) has been left-clicked.

+           Processes a @c wxEVT_COMMAND_LIST_COL_CLICK event type.

     @event{EVT_LIST_COL_RIGHT_CLICK(id, func)}
            A column (m_col) has been right-clicked.
     @event{EVT_LIST_COL_RIGHT_CLICK(id, func)}
            A column (m_col) has been right-clicked.

+           Processes a @c wxEVT_COMMAND_LIST_COL_RIGHT_CLICK event type.

     @event{EVT_LIST_COL_BEGIN_DRAG(id, func)}
            The user started resizing a column - can be vetoed.
     @event{EVT_LIST_COL_BEGIN_DRAG(id, func)}
            The user started resizing a column - can be vetoed.

+           Processes a @c wxEVT_COMMAND_LIST_COL_BEGIN_DRAG event type.

     @event{EVT_LIST_COL_DRAGGING(id, func)}
            The divider between columns is being dragged.
     @event{EVT_LIST_COL_DRAGGING(id, func)}
            The divider between columns is being dragged.

+           Processes a @c wxEVT_COMMAND_LIST_COL_DRAGGING event type.

     @event{EVT_LIST_COL_END_DRAG(id, func)}
            A column has been resized by the user.
     @event{EVT_LIST_COL_END_DRAG(id, func)}
            A column has been resized by the user.

+           Processes a @c wxEVT_COMMAND_LIST_COL_END_DRAG event type.

     @event{EVT_LIST_CACHE_HINT(id, func)}
            Prepare cache for a virtual list control.
     @event{EVT_LIST_CACHE_HINT(id, func)}
            Prepare cache for a virtual list control.

+           Processes a @c wxEVT_COMMAND_LIST_CACHE_HINT event type.

     @endEventTable
 
 
     @endEventTable
 
 


@@ -198,6 +219,9 @@ public:
 
     /**
         Deletes all items and all columns.
 
     /**
         Deletes all items and all columns.

+
+        @note  This sends an event of type @c wxEVT_COMMAND_LIST_DELETE_ALL_ITEMS
+               under all platforms.

     */
     void ClearAll();
 
     */
     void ClearAll();
 


@@ -1061,7 +1085,7 @@ protected:
     @event{EVT_LIST_ITEM_RIGHT_CLICK(id, func)}
         The right mouse button has been clicked on an item.
     @event{EVT_LIST_KEY_DOWN(id, func)}
     @event{EVT_LIST_ITEM_RIGHT_CLICK(id, func)}
         The right mouse button has been clicked on an item.
     @event{EVT_LIST_KEY_DOWN(id, func)}

-        A key has been pressed.
+        A key has been pressed. GetIndex() may be -1 if no item is selected. 

     @event{EVT_LIST_INSERT_ITEM(id, func)}
         An item has been inserted.
     @event{EVT_LIST_COL_CLICK(id, func)}
     @event{EVT_LIST_INSERT_ITEM(id, func)}
         An item has been inserted.
     @event{EVT_LIST_COL_CLICK(id, func)}