chore: Documenting members

Author: MartinZikmund

src/Uno.UI/UI/Xaml/Controls/CommandBar/CommandBarDefaultLabelPosition.cs

@@ -2,12 +2,25 @@
 using System.Collections.Generic;
 using System.Text;
 
-namespace Microsoft.UI.Xaml.Controls
+namespace Microsoft.UI.Xaml.Controls;
+
+/// <summary>
+/// Defines constants that specify the placement and visibility of AppBarButton labels in a CommandBar.
+/// </summary>
+public enum CommandBarDefaultLabelPosition
 {
-	public enum CommandBarDefaultLabelPosition
-	{
-		Bottom,
-		Right,
-		Collapsed,
-	}
+	/// <summary>
+	/// App bar button labels are shown below the icon. Labels are visible only when the command bar is open.
+	/// </summary>
+	Bottom = 0,
+
+	/// <summary>
+	/// App bar button labels are shown to the right of the icon. Labels are visible even when the command bar is closed.
+	/// </summary>
+	Right = 1,
+
+	/// <summary>
+	/// App bar button labels are always hidden whether the command bar is open or closed.
+	/// </summary>
+	Collapsed = 2,
 }

src/Uno.UI/UI/Xaml/Controls/CommandBar/CommandBarDynamicOverflowAction.cs

@@ -2,11 +2,20 @@
 using System.Collections.Generic;
 using System.Text;
 
-namespace Microsoft.UI.Xaml.Controls
+namespace Microsoft.UI.Xaml.Controls;
+
+/// <summary>
+/// Defines constants that specify whether items were added to or removed from the CommandBar overflow menu.
+/// </summary>
+public enum CommandBarDynamicOverflowAction
 {
-	public enum CommandBarDynamicOverflowAction
-	{
-		AddingToOverflow,
-		RemovingFromOverflow,
-	}
+	/// <summary>
+	/// Items are added to the overflow menu.
+	/// </summary>
+	AddingToOverflow = 0,
+
+	/// <summary>
+	/// Items are removed from the overflow menu.
+	/// </summary>
+	RemovingFromOverflow = 1,
 }

src/Uno.UI/UI/Xaml/Controls/CommandBar/CommandBarLabelPosition.cs

@@ -2,11 +2,20 @@
 using System.Collections.Generic;
 using System.Text;
 
-namespace Microsoft.UI.Xaml.Controls
+namespace Microsoft.UI.Xaml.Controls;
+
+/// <summary>
+/// Defines constants that specify the placement and visibility of an app bar button's label.
+/// </summary>
+public enum CommandBarLabelPosition
 {
-	public enum CommandBarLabelPosition
-	{
-		Default,
-		Collapsed,
-	}
+	/// <summary>
+	/// The placement and visibility of the app bar button's label is determined by the value of the CommandBar.DefaultLabelPosition property.
+	/// </summary>
+	Default,
+
+	/// <summary>
+	/// The app bar button's label is always hidden whether the command bar is open or closed.
+	/// </summary>
+	Collapsed,
 }

src/Uno.UI/UI/Xaml/Controls/CommandBar/CommandBarOverflowButtonVisibility.cs

@@ -2,12 +2,25 @@
 using System.Collections.Generic;
 using System.Text;
 
-namespace Microsoft.UI.Xaml.Controls
+namespace Microsoft.UI.Xaml.Controls;
+
+/// <summary>
+/// Defines constants that specify when a command bar's overflow button is shown.
+/// </summary>
+public enum CommandBarOverflowButtonVisibility
 {
-	public enum CommandBarOverflowButtonVisibility
-	{
-		Auto,
-		Visible,
-		Collapsed,
-	}
+	/// <summary>
+	/// The overflow button automatically hides when there are no secondary commands and the closed state of the CommandBar is the same as the open state.
+	/// </summary>
+	Auto = 0,
+
+	/// <summary>
+	/// The overflow button is always shown.
+	/// </summary>
+	Visible = 1,
+
+	/// <summary>
+	/// The overflow button is never shown.
+	/// </summary>
+	Collapsed = 2,
 }

src/Uno.UI/UI/Xaml/Controls/CommandBar/DynamicOverflowItemsChangingEventArgs.cs

@@ -2,14 +2,15 @@
 using System.Collections.Generic;
 using System.Text;
 
-namespace Microsoft.UI.Xaml.Controls
+namespace Microsoft.UI.Xaml.Controls;
+
+/// <summary>
+/// Provides data for the CommandBar.DynamicOverflowItemsChanging event.
+/// </summary>
+public partial class DynamicOverflowItemsChangingEventArgs
 {
-	public partial class DynamicOverflowItemsChangingEventArgs
-	{
-		public global::Microsoft.UI.Xaml.Controls.CommandBarDynamicOverflowAction Action
-		{
-			get;
-			internal set;
-		}
-	}
+	/// <summary>
+	/// Gets a value that indicates whether items were added to or removed from the CommandBar overflow menu.
+	/// </summary>
+	public CommandBarDynamicOverflowAction Action { get; internal set; }
 }

src/Uno.UI/UI/Xaml/Controls/CommandBar/ICommandBarElement.cs

@@ -2,10 +2,9 @@
 using System.Collections.Generic;
 using System.Text;
 
-namespace Microsoft.UI.Xaml.Controls
+namespace Microsoft.UI.Xaml.Controls;
+
+public partial interface ICommandBarElement
 {
-	public partial interface ICommandBarElement
-	{
-		bool IsCompact { get; set; }
-	}
+	bool IsCompact { get; set; }
 }

src/Uno.UI/UI/Xaml/Controls/CommandBar/ICommandBarElement2.cs

@@ -2,11 +2,10 @@
 using System.Collections.Generic;
 using System.Text;
 
-namespace Microsoft.UI.Xaml.Controls
+namespace Microsoft.UI.Xaml.Controls;
+
+public partial interface ICommandBarElement2
 {
-	public partial interface ICommandBarElement2
-	{
-		int DynamicOverflowOrder { get; set; }
-		bool IsInOverflow { get; }
-	}
+	int DynamicOverflowOrder { get; set; }
+	bool IsInOverflow { get; }
 }

src/Uno.UI/UI/Xaml/Controls/CommandBar/ICommandBarElement3.cs

@@ -2,10 +2,9 @@
 using System.Collections.Generic;
 using System.Text;
 
-namespace Microsoft.UI.Xaml.Controls
+namespace Microsoft.UI.Xaml.Controls;
+
+internal interface ICommandBarElement3
 {
-	internal interface ICommandBarElement3
-	{
-		bool IsInOverflow { get; set; }
-	}
+	bool IsInOverflow { get; set; }
 }

src/Uno.UI/UI/Xaml/Controls/CommandBar/ICommandBarLabeledElement.cs

@@ -2,14 +2,13 @@
 using System.Collections.Generic;
 using System.Text;
 
-namespace Microsoft.UI.Xaml.Controls
+namespace Microsoft.UI.Xaml.Controls;
+
+internal interface ICommandBarLabeledElement
 {
-	internal interface ICommandBarLabeledElement
-	{
-		void SetDefaultLabelPosition(CommandBarDefaultLabelPosition defaultLabelPosition);
+	void SetDefaultLabelPosition(CommandBarDefaultLabelPosition defaultLabelPosition);
 
-		bool GetHasBottomLabel();
+	bool GetHasBottomLabel();
 
-		bool GetHasRightLabel();
-	}
+	bool GetHasRightLabel();
 }

src/Uno.UI/UI/Xaml/Controls/CommandBar/ICommandBarOverflowElement.cs

@@ -2,7 +2,7 @@
 using System.Collections.Generic;
 using System.Text;
 
-namespace Microsoft.UI.Xaml.Controls
+namespace Microsoft.UI.Xaml.Controlsů
 {
 	internal interface ICommandBarOverflowElement
 	{