Skip to content

Latest commit

 

History

History
87 lines (63 loc) · 3.34 KB

un-trace.md

File metadata and controls

87 lines (63 loc) · 3.34 KB

UtilityNetworkTraceTool

Use named trace configurations defined in a web map to perform connected trace operations and compare results.

Features

  • Load networks and named trace configurations from a web map

  • Support for templating

  • (UWP, WPF) Identify starting point candidates, then use the inspection view to narrow the selection:

  • (UWP, WPF) Run multiple trace scenarios, then use color and name to compare results:

  • User-friendly warnings help avoid common mistakes, including specifying too many starting points or running the same trace configuration multiple times:

    Duplicated trace Too few starting points Extra starting points

Customization

The following properties enable customization (UWP, WPF only):

  • ResultItemTemplate - override the display of results
  • StartingPointItemTemplate - override the display of starting points
  • TraceTypeItemTemplate - override the display of the trace configuration choices
  • UtilityNetworkItemTemplate - override the display of the Utility Network choices

All platforms:

  • Template - allows overriding the appearance of the entire control

The following properties enable customizing symbology:

  • StartingPointSymbol
  • ResultFillSymbol
  • ResultLineSymbol
  • ResultPointSymbol

Usage

The default template for this control is optimized for a panel or side-by-side presentation with a width of around 300 dip.

.NET MAUI:

<Grid xmlns:esri="http://schemas.esri.com/arcgis/runtime/2013"
      ColumnDefinitions="*,300">
    <esri:MapView x:Name="MyMapView" />
    <esri:UtilityNetworkTraceTool GeoView="{x:Reference MyMapView}"
                                  Grid.Column="1" />
</Grid>

UWP/WinUI:

<Grid xmlns:esri="using:Esri.ArcGISRuntime.UI.Controls"
      xmlns:toolkit="using:Esri.ArcGISRuntime.Toolkit.UI.Controls">
    <Grid.ColumnDefinitions>
        <ColumnDefinition Width="*" />
        <ColumnDefinition Width="300" />
    </Grid.ColumnDefinitions>
    <esri:MapView x:Name="MyMapView" />
    <toolkit:UtilityNetworkTraceTool GeoView="{x:Bind MyMapView}"
                                     Grid.Column="1" />
</Grid>

WPF:

<Grid xmlns:esri="http://schemas.esri.com/arcgis/runtime/2013">
    <Grid.ColumnDefinitions>
        <ColumnDefinition Width="*" />
        <ColumnDefinition Width="300" />
    </Grid.ColumnDefinitions>
    <esri:MapView x:Name="MyMapView" />
    <esri:UtilityNetworkTraceTool GeoView="{Binding ElementName=MyMapView}"
                                  Grid.Column="1" />
</Grid>