Go Back   SmartClient Forums > Technical Q&A
Wiki Register Search Today's Posts Mark Forums Read

Reply
 
Thread Tools Search this Thread
  #1  
Old 8th Jun 2007, 13:25
JTinCA JTinCA is offline
Registered Developer
 
Join Date: May 2007
Posts: 14
Default doc & API consistency question

I'm having trouble intuitively using set/get methods versus accessing the fields directly.

In some cases, get/set aren't there, in some cases writing directly to a field is unsafe, but I haven't yet determined a pattern as to when to use which.

Is there a pattern I should be aware of, or is it just a matter of get/set haven't been implemented yet and they are coming soon (for example ViewPane.setLoadingMessage("...."))?

If no change is planned, a suggestion: please mirror inherited methods and fields of ancestors in the docs rather than requiring a drill up to find them.

Thanks,
JT
Reply With Quote
  #2  
Old 8th Jun 2007, 15:08
Isomorphic Isomorphic is offline
Administrator
 
Join Date: May 2006
Posts: 35,751
Default

Hi JT,

We recommend using setProperties for dynamic property setting. It automatically looks up setters. As of recently, the flags documentation links to setProperties() to make this more discoverable.

Also recent, all properties that have a getter or setter automatically link to them in docs.

About cascading properties from superclasses in the doc viewer: we've considered this, but it doesn't work well when the base class (Canvas) has 254 properties and methods. It's possible we'll add this as an option for end users in the documentation viewer. For the time being, we are selectively aliasing superclass documentation into subclasses in situations where it's likely the functionality would be used in the subclass.
Reply With Quote
Reply


Thread Tools Search this Thread
Search this Thread:

Advanced Search


© 2010,2011 Isomorphic Software. All Rights Reserved