do not use @b when referencing to functions; use final () to enable doxygen autolink

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

diff --git a/interface/wx/windowid.h b/interface/wx/windowid.h
index 7b14cce3ed907003706743c35ec9b613a45045bf..2f0308d5518e325cce32f6a40c7ec235ef2ee05c 100644 (file)
--- a/interface/wx/windowid.h
+++ b/interface/wx/windowid.h
@@ -6,31 +6,33 @@
 // Licence:     wxWindows license
 /////////////////////////////////////////////////////////////////////////////
 
+/**
+    The type of unique identifiers (ID) used for wxWindow-derived classes.
+*/
+typedef int wxWindowID;
+
 /**
     @class wxIdManager
-    @wxheader{windowid.h}
 
-    wxIdManager is responsible for allocating and releasing window IDs.  It
-    is used by wxWindow::NewControlId and
-    wxWindow::UnreserveControlId, and can also
-    be used be used directly.
+    wxIdManager is responsible for allocating and releasing window IDs.
+    It is used by wxWindow::NewControlId() and wxWindow::UnreserveControlId(),
+    and can also be used be used directly.
 
     @library{wxcore}
-    @category{FIXME}
+    @category{misc}
 
-    @see wxWindow::NewControlId, wxWindow::UnreserveControlId, @ref
-    overview_windowidsoverview "Window IDs overview"
+    @see wxWindow::NewControlId(), wxWindow::UnreserveControlId(),
+         @ref overview_windowids
 */
 class wxIdManager
 {
 public:
     /**
-        Called directly by wxWindow::NewControlId,
-        this function will create a new ID or range of IDs.  The IDs will be
-        reserved until assigned to a wxWindowIDRef()
-        or unreserved with UnreserveControlId().
-        Only ID values that are not assigned to a wxWindowIDRef()
-        need to be unreserved.
+        Called directly by wxWindow::NewControlId(), this function will create
+        a new ID or range of IDs.
+        The IDs will be reserved until assigned to a wxWindowIDRef() or unreserved
+        with UnreserveControlId().
+        Only ID values that are not assigned to a wxWindowIDRef() need to be unreserved.
 
         @param count
             The number of sequential IDs to reserve.
@@ -38,5 +40,20 @@ public:
         @return The value of the first ID in the sequence, or wxID_NONE.
     */
     static wxWindowID ReserveControlId(int count = 1);
+
+    /**
+        Called directly by wxWindow::UnreserveControlId(), this function will
+        unreserve an ID or range of IDs that is currently reserved.
+        This should only be called for IDs returned by ReserveControlId() that
+        have NOT been assigned to a wxWindowIDRef (see @ref overview_windowids).
+
+        @param id
+            The first of the range of IDs to unreserve.
+        @param count
+            The number of sequential IDs to unreserve.
+
+        @return The value of the first ID in the sequence, or wxID_NONE.
+    */
+    static wxWindowID UnreserveControlId(wxWindowID id, int count = 1);
 };