* fhGetItemText is gone, & fhGetDisplayText chan

[SimonOrde]

We've only just noticed that we have had two functions which do almost the same thing.  These were fhGetItemText and fhGetDisplayText.  The only difference between the two is that fhGetItemText took a data reference as a second parameter so you could have a line like this:

fhGetItemText(ind, '~.OCCU')

where up to now you haven't been able to do that with fhGetDisplayText.  It makes no sense to have two functions which are almost identical.  Also fhGetItemText isn't a brilliant name because it's not clear whether it's the value or a display text you're getting.  So we have decided to drop fhGetItemText altogether.  From 5.0.0.3 it won't exist any more.

fhGetDisplayText from 5.0.0.3 will take an optional 2nd parameter - a dataref.  So this is now fine:

fhGetDisplayText(ind, '~.OCCU')

Also - previously fhGetDisplayText just displayed the attribute value for an attribute.  From 5.0.0.3 it will give a better display version (in fact, it's pretty much exactly what you would see for the item in the 'All' tab of the Property Box, when its row is unexpanded.

If you need to access the value of a field as text, you should use fhGetValueAsText.

My apologies for any inconvenience caused by this change.  But a simple search replace (replace fhGetItemText with fhGetDisplayText) should quickly fix any plugins you have already written which use fhGetItemText.

ID:5607

[tatewise]

Unfortunately, a simple search/replace of fhGetItemText with fhGetDisplayText does not reliably fix any plugins that use it.
See V5 Beta Pending topic Plugin: fhGetDisplayText function for further fixes proposed for FH Beta V5.0.0.4
http://www.fhug.org.uk/cgi-bin/index.cg ... y&num=5255

Edit: fhGetItemText has been reinstated in 5.0.0.4 (see 22/12/11 posting in above thread).