Bug 312315 - TableItem/TreeItem.getBounds() needs more explicit documentation
Summary: TableItem/TreeItem.getBounds() needs more explicit documentation
Status: RESOLVED FIXED
Alias: None
Product: Platform
Classification: Eclipse Project
Component: SWT (show other bugs)
Version: 3.6   Edit
Hardware: All All
: P3 normal (vote)
Target Milestone: 3.6 RC3   Edit
Assignee: Grant Gayed CLA
QA Contact:
URL:
Whiteboard:
Keywords: Documentation
Depends on:
Blocks:
 
Reported: 2010-05-10 14:07 EDT by Scott Kovatch CLA
Modified: 2010-05-21 14:15 EDT (History)
0 users

See Also:

Attachments
Add an attachment (proposed patch, testcase, etc.)

Note You need to log in before you can comment on or make changes to this bug.
Description Scott Kovatch CLA 2010-05-10 14:07:49 EDT 
While fixing 309753 there was some confusion on my part about what TreeItem.getBounds() is really returning. It should return the bounds of the text portion of the item, but it's not clear from the javadoc that that is the case. If there is an image set for the item it isn't part of the bounds.

Likewise, there's no documentation that I can find about SWT.MeasureItem, EraseItem and PaintItem. The snippets show how they are being used, but there's no documentation about the values sent in the event.
Comment 1 Grant Gayed CLA 2010-05-21 14:15:49 EDT 
The missing API spec for custom draw is part of bug 81334.  As a side note (not implying that this is a substitute for the javadoc) custom draw is described in http://www.eclipse.org/articles/article.php?file=Article-CustomDrawingTableAndTreeItems/index.html .

The javadoc for getBounds() has been clarified for Table/Tree > 20100521.