Toolkit concept docs XAML: batch 2 (#558)

Esri · May 4, 2024 · 4bd6d21 · 4bd6d21
1 parent 74f5783
commit 4bd6d21
Show file tree

Hide file tree

Showing 4 changed files with 88 additions and 52 deletions.
diff --git a/README.md b/README.md
@@ -27,7 +27,7 @@ The ArcGIS Maps SDK for .NET Toolkit contains controls and components to acceler
 |[FloorFilter](docs/floor-filter.md) | ![image](https://user-images.githubusercontent.com/29742178/158746908-71a39e28-596f-44b6-9230-e2a04bdaeb9e.png) | Browse floor-aware maps and scenes and filter the view to show levels in a facility. | WinUI, MAUI, UWP, WPF |
 |[GeoViewController](docs/geoviewcontroller.md) | | A helper class to enable easy adoption of MVVM patterns in an ArcGIS Maps SDK for .NET application. | WinUI, MAUI, UWP, WPF |
 | [Legend](docs/legend.md)   | <img src="https://user-images.githubusercontent.com/1378165/73389924-011fc200-428a-11ea-91bf-4ea1c2bf6683.png" width="105" title="Legend" />| Display a legend for a map or scene view. | WinUI, MAUI, UWP, WPF |
-| [MeasureToolbar](docs/measure-toolbar.md)  | ![MeasureToolbar](https://user-images.githubusercontent.com/1378165/73389958-0f6dde00-428a-11ea-8c78-7192d49ea605.png) | Measure distances, areas, and features in a map view. | UWP, WPF |
+| [MeasureToolbar](docs/measure-toolbar.md)  | ![MeasureToolbar](https://user-images.githubusercontent.com/1378165/73389958-0f6dde00-428a-11ea-8c78-7192d49ea605.png) | Measure distances, areas, and features in a map view. | WinUI, UWP, WPF |
 |[OverviewMap](docs/overview-map.md) | <img src="https://user-images.githubusercontent.com/29742178/121975740-34f07000-cd37-11eb-9162-462925cb3fe7.png" width="150" title="Overview Map" /> | Display an interactive inset map for a map or scene. | WinUI, MAUI, UWP, WPF |
 |[PopupViewer](docs/popup-viewer.md) | <img src="https://user-images.githubusercontent.com/3878047/228625594-d0009216-0cb3-4836-9a62-e197371779ac.png" width="150" title="Popup Viewer" /> | Displays information from simple popups. | WinUI, MAUI, UWP, WPF |
 | [ScaleLine](docs/scale-line.md)   | ![ScaleLine](https://user-images.githubusercontent.com/1378165/73390077-3debb900-428a-11ea-8b2f-dfd4914a637e.png) | Display the current scale reference for a map. | WinUI, MAUI, UWP, WPF |

diff --git a/docs/legend.md b/docs/legend.md
@@ -13,6 +13,42 @@ Display a legend for a map or scene view.
 
 ## Usage
 
+### .NET MAUI:
+
+```xml
+<Grid xmlns:esri="http://schemas.esri.com/arcgis/runtime/2013"
+      ColumnDefinitions="*,300">
+    <esri:MapView x:Name="MyMapView"/>
+    <esri:Legend GeoView="{x:Bind MyMapView}"
+                 Grid.Column="1" />
+</Grid>
+```
+
+### UWP/WinUI:
+
+```xml
+<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:Legend GeoView="{Binding ElementName=MyMapView}"
+                    Grid.Column="1" />
+</Grid>
+```
+
+### WPF:
+
 ```xml
-<esri:Legend GeoView="{Binding ElementName=mapView}" />
-```
+<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:Legend GeoView="{Binding ElementName=MyMapView}"
+                 Grid.Column="1" />
+</Grid>
+```
diff --git a/docs/measure-toolbar.md b/docs/measure-toolbar.md
@@ -13,6 +13,33 @@ Measure distances, areas, and features in a `MapView`.
 
 ## Usage
 
+### UWP/WinUI:
+
+```xml
+<Grid xmlns:esri="using:Esri.ArcGISRuntime.UI.Controls"
+      xmlns:toolkit="using:Esri.ArcGISRuntime.Toolkit.UI.Controls">
+    <Grid.RowDefinitions>
+        <RowDefinition Height="50" />
+        <RowDefinition Height="*" />
+    </Grid.RowDefinitions>
+    <toolkit:MeasureToolbar HorizontalAlignment="Center"
+                            MapView="{x:Bind MyMapView}" />
+    <esri:MapView x:Name="MyMapView"
+                  Grid.Row="1" />
+</Grid>
+```
+
+### WPF:
+
 ```xml
-<esri:MeasureToolbar MapView="{Binding ElementName=mapView}" />
-```
+<Grid xmlns:esri="http://schemas.esri.com/arcgis/runtime/2013">
+    <Grid.RowDefinitions>
+        <RowDefinition Height="50" />
+        <RowDefinition Height="*" />
+    </Grid.RowDefinitions>
+    <esri:MeasureToolbar HorizontalAlignment="Center"
+                         MapView="{Binding ElementName=MyMapView}" />
+    <esri:MapView x:Name="MyMapView"
+                  Grid.Row="1" />
+</Grid>
+```
diff --git a/docs/overview-map.md b/docs/overview-map.md
@@ -28,60 +28,33 @@ OverviewMap has the following bindable properties:
 
 ## Usage
 
-UWP:
+### .NET MAUI:
 
 ```xml
-<Page
-    x:Class="Esri.ArcGISRuntime.Toolkit.SampleApp.Samples.OverviewMap.OverviewMapSample"
-    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
-    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
-    xmlns:esri="using:Esri.ArcGISRuntime.UI.Controls"
-    xmlns:overviewmap="using:Esri.ArcGISRuntime.Toolkit.UI.Controls.OverviewMap">
-    <Grid Background="{ThemeResource ApplicationPageBackgroundThemeBrush}">
-        <esri:MapView x:Name="mapView" />
-        <overviewmap:OverviewMap
-            Margin="4"
-            GeoView="{Binding ElementName=mapView}" />
-    </Grid>
-</Page>
+<Grid xmlns:esri="http://schemas.esri.com/arcgis/runtime/2013">
+    <esri:MapView x:Name="MyMapView" />
+    <esri:OverviewMap Margin="4"
+                      GeoView="{x:Bind MyMapView}" />
+</Grid>
 ```
 
-WPF:
+### WinUI/UWP:
 
 ```xml
-<UserControl
-    x:Class="Esri.ArcGISRuntime.Toolkit.Samples.OverviewMap.OverviewMapWithSceneSample"
-    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
-    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
-    xmlns:esri="http://schemas.esri.com/arcgis/runtime/2013"
-    xmlns:overviewmap="clr-namespace:Esri.ArcGISRuntime.Toolkit.UI.Controls.OverviewMap;assembly=Esri.ArcGISRuntime.Toolkit">
-    <Grid>
-        <esri:SceneView x:Name="MySceneView" />
-        <overviewmap:OverviewMap
-            Margin="4"
-            GeoView="{Binding ElementName=MySceneView}" />
-    </Grid>
-</UserControl>
+<Grid xmlns:esri="using:Esri.ArcGISRuntime.UI.Controls"
+      xmlns:toolkit="using:Esri.ArcGISRuntime.Toolkit.UI.Controls">
+    <esri:MapView x:Name="MyMapView" />
+    <toolkit:OverviewMap Margin="4"
+                         GeoView="{Binding ElementName=MyMapView}" />
+</Grid>
 ```
 
-MAUI:
+### WPF:
 
 ```xml
-<ContentPage x:Class="Toolkit.Samples.Forms.Samples.OverviewMapWithSceneSample"
-             xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
-             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
-             xmlns:esriTK="clr-namespace:Esri.ArcGISRuntime.Toolkit.Maui;assembly=Esri.ArcGISRuntime.Toolkit.Maui"
-             xmlns:esriUI="clr-namespace:Esri.ArcGISRuntime.Maui;assembly=Esri.ArcGISRuntime.Maui">
-    <ContentPage.Content>
-        <Grid>
-            <esriUI:SceneView x:Name="sceneView" />
-            <StackLayout Margin="4"
-                         HorizontalOptions="Start"
-                         VerticalOptions="Start">
-                <esriTK:OverviewMap GeoView="{Binding Source={x:Reference sceneView}}" />
-            </StackLayout>
-
-        </Grid>
-    </ContentPage.Content>
-</ContentPage>
-```
+<Grid xmlns:esri="http://schemas.esri.com/arcgis/runtime/2013">
+    <esri:MapView x:Name="MyMapView" />
+    <esri:OverviewMap Margin="4"
+                      GeoView="{Binding ElementName=MyMapView}" />
+</Grid>
+```