This Bugzilla instance is a read-only archive of historic NetBeans bug reports. To report a bug in NetBeans please follow the project's instructions for reporting issues.
Summary: | Update documentation for proppanel_rewrite | ||
---|---|---|---|
Product: | platform | Reporter: | Jaroslav Tulach <jtulach> |
Component: | Explorer | Assignee: | _ tboudreau <tboudreau> |
Status: | VERIFIED FIXED | ||
Severity: | blocker | ||
Priority: | P2 | ||
Version: | 3.x | ||
Hardware: | PC | ||
OS: | Linux | ||
Issue Type: | DEFECT | Exception Reporter: | |
Bug Depends on: | |||
Bug Blocks: | 37626 | ||
Attachments: | Revised diff of api & arch docs |
Description
Jaroslav Tulach
2003-12-05 10:34:19 UTC
"postSetAction" is an enhancement I put in specifically so the form editor could stop using EnhancedPropertyEditor. They use it so they can listen to the combo box and open the editor on an event method, only if the *user* sets the property value. Otherwise they might set the editor position just because something programmatically set the value of the property. So, now, if your property provides an implementation of Action via getValue("postSetAction"), that code will be run if and only if the user explicitly sets the property value. It is an open question whether "postSetAction" should remain undocumented (but tested) as a friend contract, or should be made public. I'm guessing it can do no harm as long as we document it as not necessarily permanently supported. Will attach a revised diff. Jarda, I'm not exactly sure where and how I should be using API tags in this doc. Can you advise? Created attachment 12443 [details]
Revised diff of api & arch docs
Marking this issue as fixed - if you still feel the docs aren't sufficient, reopen. And do advise where and how to use the <api> tag - we could probably just do this together on Monday. Info about using the API tags can be found here: http://openide.netbeans.org/tutorial/api.html if you edit the XML in NetBeans you will get code completion. postSetAction can be friend contract. Just document that in the arch-*-document. Closing per our agreement - Jarda, we'll do the API tags thing when I get to the office. Please use javax.swing.UIManager group. Also are you sure you really want friend category: http://openide.netbeans.org/tutorial/api-design.html#category-friend It means that there are component's that are really using this properties, you know about them and you will notify them if you change the contract. Stuff like netbeans.ps.combohack or netbeans.reusable.strictthreads looks like private impl. detail while flat could be deprecated. Please rething and review that as well. Done. Ok. |