Phil Weinstein, CADSWES, 12-04-2011

Short Description: Fix to AggObj Account workspace item persistence.
Bug Number: 5134
Release notes (y/n): No (not in 6.2)
For Release Nums: 6.1 and 6.2

In the Accounting Workspace, for Aggregate Objects (e.g. Aggregate Reachs),
account icons for all of the accounts on the Aggregate Object AND all of
its child 'element' objects are displayed together in a single row within
the rectangular region for the Aggregate Object.  The user can arrange 
those account icons in any order (by dragging with the mouse).

However, when saving and reloading the model file, the account icons are
effectively resorted by the element objects containing those accounts.
This is incorrect.

This was a problem in the original implementation of the Accounting 
Workspace, and remains in RiverWare 6.0.  I recommend that we fix this
in RiverWare 6.1 or in an early 6.1 patch release.  

See also Gnats 5130, which has been addressed. ('RiverWare 6.0 to 6.1: 
Loss of Account graphic item order.').

This was addressed by saving the Account _displayPosition (integer) field 
within the Account record serialization (for model files and export object 
files) -- rather than having the 'display position' be implicit, based on 
the order of Account records within the object serialization (which is 
relative to only the containing element object).

Serialization Example (for Tcl parsing):

  set o "$obj^MyPass"
  "$o" water {NONE} {NONE}
  "$o" acctDisplayPos 3     <<< ADDED <<<
  "$o" storage 0

----------------------
Accounting/Account.hpp
Accounting/Account.cpp
----------------------

New private Tcl-processing method:
  int acctDisplayPos_cmd (Tcl_Interp*, int argc, char **argv);

Output generation in method: 
  bool Account::save (cwostream&) const;

Parsing hook in method:
  int accountCmd (ClientData, Tcl_Interp*, int argc, char **argv)
  ... calls new method (see above).

Account Tcl command error message utility method, enhanced:
  void Account::getTclCmds (QString &cmds) const

---