diff --git a/interface/wx/dataview.h b/interface/wx/dataview.h index 8d087a9367..e98ab8a387 100644 --- a/interface/wx/dataview.h +++ b/interface/wx/dataview.h @@ -155,7 +155,8 @@ public: @param column The column holding the items to be compared. @param ascending - The sort is being peformed in ascending or descending order. + Indicates whether the sort is being performed in ascending or + descending order. @return For an ascending comparison: a negative value if the item1 is less than (i.e. should appear above) item2, zero if the two items are @@ -163,11 +164,12 @@ public: appear below) the second one. The reverse for a descending comparison. @note If there can be multiple rows with the same value, consider - differentiating them form each other by their ID's rather than + differentiating them form each other by their IDs rather than returning zero. This to prevent rows with the same value jumping positions when items are added etc. For example: @code - // Differentiate items with the same value. + // Note that we need to distinguish between items with the same + // value. wxUIntPtr id1 = wxPtrToUInt(item1.GetID()), id2 = wxPtrToUInt(item2.GetID()); @@ -1956,7 +1958,7 @@ public: /** Sets the alignment of the renderer's content. - The default value of @c wxDVR_DEFAULT_ALIGMENT indicates that the content + The default value of @c wxDVR_DEFAULT_ALIGNMENT indicates that the content should have the same alignment as the column header. The method is not implemented under OS X and the renderer always aligns