On Jul 1, 2009, at 7:32 PM, Bill Cheeseman wrote:
NSButton does conform to the NSValidatedUserInterfaceItem protocol, as its header file confirms
According to the header file and documentation I'm looking at, NSButton conforms to the *other* protocol (NSUserInterfaceValidations), which is the one you implement when you want to validate, not be validated.
Nevertheless, I think I remember being confused by that documentation in exactly the same way, and I think it is very much worth a Radar. I've submitted rdar://problem/7026464, in which I make the following suggestions:
* Instead of the very general term "user interface items ", introduce the term "*validated* user interface items", or simply "validated items", which describes them precisely and forms a clear association with the protocol name PSValidatedUserInterfaceItem.
* Use the terms consistently everywhere -- on the "Implementing a Validated Item" page the term "validated objects" is used.
* To avoid confusion, make it clear that only NSMenuItem and NSToolbarItem (or whatever the list is) are validating [sic -- d'oh] items, though of course developers can implement others.
...I read mmalc's post before submitting the Radar (in fact I referred to the rdar he mentioned) but it only just now registered that he quotes a part of the docs that sort of says the thing about NSMenuItem and NSToolbarItem. But still I think it could be clearer, and might be worth stating in more than one place.
--Andy _______________________________________________ Cocoa-dev mailing list ([email protected]) Please do not post admin requests or moderator comments to the list. Contact the moderators at cocoa-dev-admins(at)lists.apple.com Help/Unsubscribe/Update your Subscription: http://lists.apple.com/mailman/options/cocoa-dev/archive%40mail-archive.com This email sent to [email protected]
