TraceResultsWindow Command


Description:

The TraceResultsWindow Command brings up a dockable window for storing and displaying trace results during the current ArcMap session. After running a Trace, the Add button on the Trace Results Window is used to hold onto the results along with the currently selected color. Additional traces can then be run with all results displayable through the window based on the display color active when the results were added.

The Trace Results Window has options for specifying which saved traces to display with the next redraw. Traces can be removed from the window at any time. Features can also be selected based on the trace selected from the window.
Products:
ArcEditor: VB6

Platforms: Windows

Requires: Network data.

Minimum ArcGIS Release: 9.0

How to use:
  1. Register the dll on your machine. Use Categories.exe (found under the ArcInfo bin directory) to add the dll the appropriate component categories. Add the TraceResultsWin class to 'ESRI Mx Dockable Windows' and TraceResultsCmd class to 'ESRI Mx Commands'.
  2. Start an ArcMap session and load your network date. Turn on the Utility Network Analysis toolbar.
  3. Bring up the customize dialog and find the "Trace Results Window ..." command under the Developer Samples category. Drag and drop this command onto the Analysis dropdown of the Utility Network Analysis toolbar.
  4. Select the "Trace Results Window ..." command and a new dockable window will be displayed. Dock the window as desired.
  5. Execute a trace as you would normally. Select the "Add" button on the Trace Results Window and the last trace will be added. The color of the entry in the window corresponds to the color the results will be drawn in. Add additional traces to the window as desired.
  6. To stop a trace from drawing, uncheck it in the Results window.
  7. To remove a trace from the window, highlight it and then select the "Remove" button.
  8. To remove all traces select the "Remove All" button.
  9. To select features higlight the trace you are interested in and then click on the "Selection Set" button.
  10. The Layer Subsets button will select features based on the specified trace, then create new layers in a single group layer based on the selection. This would allow the user to make a plot of just the results of the trace.
  11. The Path Cost button will popup the cost of a Find Path trace (the cost is based on specified weights - or simply the number of features traversed if no weight has been specified), but will not show the cost of any other trace.
  12. Use the Up and Down arrows to change the drawing order of the saved traces.

Download the VB6 files
frmTraceResults.frm Form containing the controls for the Trace Results Window.
TraceResults.cls
(view code)
Internal class used to keep track of the trace results.
TraceResultsCmd.cls
(view code)
Class for bringing up the Trace Results dockable window.
TraceResultsWin.cls
(view code)
Class for defining the dockable window and displaying the trace results.
TraceResultsWinPrj.vbp Project file for the Trace Resuls Window project.

Download the files for all languages



Key CoClasses:UtilityNetworkAnalysisExt
Key Interfaces: IEnumNetEid, ITraceTasks, ITraceTaskResult, IUtilityNetworkAnalsisExt, IUtilityNetworkAnalsisExtResultColor
Key Members:IEnumNetEid::Next, ITraceTasks::CurrentTask, ITraceTaskResult::ResultEdges, ITraceTaskResult::ResultJunctions, IUtilityNetworkAnalsisExt::CurrentNetwork, IUtilityNetworkAnalsisExtResultColor::Color