Update BListItem::SetHeight() docs with selection box warning.

The cached top coordinate of each BListItem isn't updated when you
change the height of the item, leading to confusing highlighting and
incorrect mouse clicks.  Rather than fixing it, this just documents a
workaround or two to force an update of the cached coordinates.
This commit is contained in:
Alexander G. M. Smith 2017-11-07 12:56:15 -05:00 committed by Skipp_OSX
parent a298f79ff9
commit f12d3b3477

View File

@ -172,6 +172,16 @@
\param height The height to set the list item to.
\note Unlike BeOS, if you change the height then you need to force
the BListView to recalculate the cached tops of the item
selection boxes, otherwise selection highlights will be drawn
in the wrong places and mouse clicks will be misinterpreted.
You can do this by adding and removing a dummy BListItem at
the top of the list, or after hrev50780 by calling
BListView::FrameResized() with the current Frame rectangle
(though the FrameResized() method will additionally call
BListItem::Update() for all items).
\since BeOS R3
*/