1.4.0

Microsoft.Toolkit.Uwp.DeveloperTools/AlignmentGrid/AlignmentGrid.cs

@@ -0,0 +1,132 @@
+// ******************************************************************
+// Copyright (c) Microsoft. All rights reserved.
+// This code is licensed under the MIT License (MIT).
+// THE CODE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
+// INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+// IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
+// DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+// TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH
+// THE CODE OR THE USE OR OTHER DEALINGS IN THE CODE.
+// ******************************************************************
+
+using Windows.UI.Xaml;
+using Windows.UI.Xaml.Controls;
+using Windows.UI.Xaml.Media;
+using Windows.UI.Xaml.Shapes;
+
+namespace Microsoft.Toolkit.Uwp.DeveloperTools
+{
+    /// <summary>
+    /// AlignmentGrid is used to display a grid to help aligning controls
+    /// </summary>
+    public class AlignmentGrid: ContentControl
+    {
+        /// <summary>
+        /// Identifies the <see cref="LineBrush"/> dependency property.
+        /// </summary>
+        public static readonly DependencyProperty LineBrushProperty = DependencyProperty.Register(nameof(LineBrush), typeof(Brush), typeof(AlignmentGrid), new PropertyMetadata(null, OnPropertyChanged));
+
+        /// <summary>
+        /// Identifies the <see cref="HorizontalStep"/> dependency property.
+        /// </summary>
+        public static readonly DependencyProperty HorizontalStepProperty = DependencyProperty.Register(nameof(HorizontalStep), typeof(double), typeof(AlignmentGrid), new PropertyMetadata(20.0, OnPropertyChanged));
+
+        /// <summary>
+        /// Identifies the <see cref="VerticalStep"/> dependency property.
+        /// </summary>
+        public static readonly DependencyProperty VerticalStepProperty = DependencyProperty.Register(nameof(VerticalStep), typeof(double), typeof(AlignmentGrid), new PropertyMetadata(20.0, OnPropertyChanged));
+
+        private static void OnPropertyChanged(DependencyObject dependencyObject, DependencyPropertyChangedEventArgs e)
+        {
+            var alignmentGrid = dependencyObject as AlignmentGrid;
+
+            alignmentGrid?.Rebuild();
+        }
+
+        private readonly Canvas containerCanvas = new Canvas();
+
+        /// <summary>
+        /// Gets or sets the step to use horizontally.
+        /// </summary>
+        public Brush LineBrush
+        {
+            get { return (Brush)GetValue(LineBrushProperty); }
+            set { SetValue(LineBrushProperty, value); }
+        }
+
+        /// <summary>
+        /// Gets or sets the step to use horizontally.
+        /// </summary>
+        public double HorizontalStep
+        {
+            get { return (double)GetValue(HorizontalStepProperty); }
+            set { SetValue(HorizontalStepProperty, value); }
+        }
+
+        /// <summary>
+        /// Gets or sets the step to use horizontally.
+        /// </summary>
+        public double VerticalStep
+        {
+            get { return (double)GetValue(VerticalStepProperty); }
+            set { SetValue(VerticalStepProperty, value); }
+        }
+
+
+        /// <summary>
+        /// Initializes a new instance of the <see cref="AlignmentGrid"/> class.
+        /// </summary>
+        public AlignmentGrid()
+        {
+            SizeChanged += AlignmentGrid_SizeChanged;
+
+            IsHitTestVisible = false;
+
+            Opacity = 0.5;
+
+            HorizontalContentAlignment = HorizontalAlignment.Stretch;
+            VerticalContentAlignment = VerticalAlignment.Stretch;
+            Content = containerCanvas;
+        }
+
+        private void Rebuild()
+        {
+            containerCanvas.Children.Clear();
+            var horizontalStep = HorizontalStep;
+            var verticalStep = VerticalStep;
+            var brush = LineBrush ?? (Brush)Application.Current.Resources["ApplicationForegroundThemeBrush"];
+
+            for (double x = 0; x < ActualWidth; x += horizontalStep)
+            {
+                var line = new Rectangle
+                {
+                    Width = 1,
+                    Height = ActualHeight,
+                    Fill = brush
+                };
+                Canvas.SetLeft(line, x);
+
+                containerCanvas.Children.Add(line);
+            }
+
+            for (double y = 0; y < ActualHeight; y += verticalStep)
+            {
+                var line = new Rectangle
+                {
+                    Width = ActualWidth,
+                    Height = 1,
+                    Fill = brush
+                };
+                Canvas.SetTop(line, y);
+
+                containerCanvas.Children.Add(line);
+            }
+        }
+
+        private void AlignmentGrid_SizeChanged(object sender, SizeChangedEventArgs e)
+        {
+            Rebuild();
+        }
+    }
+}

Microsoft.Toolkit.Uwp.DeveloperTools/FocusTracker/FocusTracker.cs

@@ -0,0 +1,153 @@
+// ******************************************************************
+// Copyright (c) Microsoft. All rights reserved.
+// This code is licensed under the MIT License (MIT).
+// THE CODE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
+// INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+// IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
+// DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+// TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH
+// THE CODE OR THE USE OR OTHER DEALINGS IN THE CODE.
+// ******************************************************************
+
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+using Windows.UI.Xaml;
+using Windows.UI.Xaml.Automation;
+using Windows.UI.Xaml.Controls;
+using Windows.UI.Xaml.Controls.Primitives;
+using Windows.UI.Xaml.Input;
+using Windows.UI.Xaml.Media;
+using Windows.UI.Xaml.Shapes;
+
+namespace Microsoft.Toolkit.Uwp.DeveloperTools
+{
+    /// <summary>
+    /// FocusTracker can be used to display information about the current focused XAML element.
+    /// </summary>
+    [TemplatePart(Name = "ControlName", Type = typeof(TextBlock))]
+    [TemplatePart(Name = "ControlType", Type = typeof(TextBlock))]
+    [TemplatePart(Name = "ControlAutomationName", Type = typeof(TextBlock))]
+    [TemplatePart(Name = "ControlFirstParentWithName", Type = typeof(TextBlock))]
+    public class FocusTracker: Control
+    {
+        /// <summary>
+        /// Defines the <see cref="IsActive"/> dependency property.
+        /// </summary>
+        public static readonly DependencyProperty IsActiveProperty = DependencyProperty.Register(nameof(IsActive), typeof(bool), typeof(FocusTracker), new PropertyMetadata(false, OnIsActiveChanged));
+
+        private static void OnIsActiveChanged(DependencyObject d, DependencyPropertyChangedEventArgs e)
+        {
+            var focusTracker = d as FocusTracker;
+
+            if (e.NewValue != null && (bool) e.NewValue)
+            {
+                focusTracker?.Start();
+            }
+            else
+            {
+                focusTracker?.Stop();
+            }
+        }
+
+        private DispatcherTimer updateTimer;
+        private TextBlock controlName;
+        private TextBlock controlType;
+        private TextBlock controlAutomationName;
+        private TextBlock controlFirstParentWithName;
+
+        /// <summary>
+        /// Gets or sets a boolean indicating whether the tracker is running or not.
+        /// </summary>
+        public bool IsActive
+        {
+            get { return (bool) GetValue(IsActiveProperty); }
+            set
+            {
+                SetValue(IsActiveProperty, value);
+            }
+        }
+
+        /// <summary>
+        /// Initializes a new instance of the <see cref="FocusTracker"/> class.
+        /// </summary>
+        public FocusTracker()
+        {
+            DefaultStyleKey = typeof(FocusTracker);
+        }
+
+        private void Start()
+        {
+            if (updateTimer == null)
+            {
+                updateTimer = new DispatcherTimer();
+                updateTimer.Tick += UpdateTimer_Tick;
+            }
+            updateTimer.Start();
+        }
+
+        private void Stop()
+        {
+            updateTimer?.Stop();
+            ClearContent();
+        }
+
+        /// <summary>
+        /// Update the visual state of the control when its template is changed.
+        /// </summary>
+        protected override void OnApplyTemplate()
+        {
+            controlName = GetTemplateChild("ControlName") as TextBlock;
+            controlType = GetTemplateChild("ControlType") as TextBlock;
+            controlAutomationName = GetTemplateChild("ControlAutomationName") as TextBlock;
+            controlFirstParentWithName = GetTemplateChild("ControlFirstParentWithName") as TextBlock;
+        }
+
+        private void ClearContent()
+        {
+            controlName.Text = string.Empty;
+            controlType.Text = string.Empty;
+            controlAutomationName.Text = string.Empty;
+            controlFirstParentWithName.Text = string.Empty;
+        }
+
+        private void UpdateTimer_Tick(object sender, object e)
+        {
+            var focusedControl = FocusManager.GetFocusedElement() as FrameworkElement;
+
+            if (focusedControl == null)
+            {
+                ClearContent();
+                return;
+            }
+
+            controlName.Text = focusedControl.Name;
+            controlType.Text = focusedControl.GetType().Name;
+            controlAutomationName.Text = AutomationProperties.GetName(focusedControl);
+
+            var parentWithName = FindVisualAscendantWithName(focusedControl);
+
+            controlFirstParentWithName.Text = parentWithName?.Name ?? string.Empty;
+        }
+
+        private FrameworkElement FindVisualAscendantWithName(FrameworkElement element)
+        {
+            var parent = VisualTreeHelper.GetParent(element) as FrameworkElement;
+
+            if (parent == null)
+            {
+                return null;
+            }
+
+            if (!string.IsNullOrEmpty(parent.Name))
+            {
+                return parent;
+            }
+
+            return FindVisualAscendantWithName(parent);
+        }
+    }
+}

Microsoft.Toolkit.Uwp.DeveloperTools/FocusTracker/FocusTracker.xaml

@@ -0,0 +1,74 @@
+<ResourceDictionary xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
+                    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
+                    xmlns:developerTools="using:Microsoft.Toolkit.Uwp.DeveloperTools">
+
+    <Style TargetType="developerTools:FocusTracker">
+        <Setter Property="IsTabStop" Value="False"></Setter>
+        <Setter Property="MinWidth" Value="300"></Setter>
+        <Setter Property="Foreground" Value="{ThemeResource ApplicationForegroundThemeBrush}"></Setter>
+        <Setter Property="Background" Value="{ThemeResource ApplicationPageBackgroundThemeBrush}"></Setter>
+        <Setter Property="Template">
+            <Setter.Value>
+                <ControlTemplate>
+                    <Grid>
+                        <Border Background="{TemplateBinding Background}"
+                            BorderBrush="{TemplateBinding Foreground}"
+                            BorderThickness="1"
+                        />
+                        <Grid Padding="10,10,10,5">
+                            <Grid.RowDefinitions>
+                                <RowDefinition Height="30"/>
+                                <RowDefinition Height="30"/>
+                                <RowDefinition Height="30"/>
+                                <RowDefinition Height="30"/>
+                                <RowDefinition Height="20"/>
+                            </Grid.RowDefinitions>
+                            <Grid.ColumnDefinitions>
+                                <ColumnDefinition Width="180"/>
+                                <ColumnDefinition/>
+                            </Grid.ColumnDefinitions>
+                            <TextBlock Text="Name:"
+                                       FontSize="14"
+                                       Grid.Row="0"
+                                       Grid.Column="0"/>
+                            <TextBlock x:Name="ControlName"
+                                       Grid.Row="0"
+                                       Grid.Column="1"/>
+
+                            <TextBlock Text="Type:"
+                                       FontSize="14"
+                                       Grid.Row="1"
+                                       Grid.Column="0"/>
+                            <TextBlock x:Name="ControlType"
+                                       Grid.Row="1"
+                                       Grid.Column="1"/>
+
+                            <TextBlock Text="Automation.Name:"
+                                       FontSize="14"
+                                       Grid.Row="2"
+                                       Grid.Column="0"/>
+                            <TextBlock x:Name="ControlAutomationName"
+                                       Grid.Row="2"
+                                       Grid.Column="1"/>
+
+                            <TextBlock Text="Parent with Name:"
+                                       FontSize="14" 
+                                       Grid.Row="3"
+                                       Grid.Column="0"/>
+                            <TextBlock x:Name="ControlFirstParentWithName"
+                                       Grid.Row="3"
+                                       Grid.Column="1"/>
+
+                            <TextBlock Text="FocusTracker"
+                                       Opacity="0.5"
+                                       FontSize="14"
+                                       HorizontalAlignment="Center"
+                                       Grid.Row="4"
+                                       Grid.ColumnSpan="2"/>
+                        </Grid>
+                    </Grid>
+                </ControlTemplate>
+            </Setter.Value>
+        </Setter>
+    </Style>
+</ResourceDictionary>