Merge branch 'main' into issue757

Author: maxkoshevoi

README.md

@@ -46,7 +46,7 @@ xmlns:xct="http://xamarin.com/schemas/2020/toolkit">
 
 ## Documentation
 
-The documentation is currently under construction at the [official Docs repo](https://github.com/MicrosoftDocs/xamarin-communitytoolkit). We're working to get these published as soon as possible. For now, please refer to the markdown files that are in the repo. Contributions to the Docs are very much welcomed!
+The documentation is still under construction, but we've published the most important things over at [Microsoft Docs](https://docs.microsoft.com/en-us/xamarin/community-toolkit/). If you want to contribute some of the missing bits you can do this over at the [official Docs repo](https://github.com/MicrosoftDocs/xamarin-communitytoolkit) as contributions are very much welcomed!
 
 ## Contributions welcome!
 

samples/XCT.Sample.Tizen/Main.cs

@@ -1,4 +1,4 @@
-using System;
+using System;
 using Xamarin.Forms;
 
 namespace Xamarin.CommunityToolkit.Sample.Tizen

samples/XCT.Sample.UWP/App.xaml.cs

@@ -20,16 +20,16 @@ namespace Xamarin.CommunityToolkit.Sample.UWP
 	/// <summary>
 	/// Provides application-specific behavior to supplement the default Application class.
 	/// </summary>
-	sealed partial class App : Application
+	public sealed partial class App : Application
 	{
 		/// <summary>
 		/// Initializes the singleton application object.  This is the first line of authored code
 		/// executed, and as such is the logical equivalent of main() or WinMain().
 		/// </summary>
 		public App()
 		{
-			this.InitializeComponent();
-			this.Suspending += OnSuspending;
+			InitializeComponent();
+			Suspending += OnSuspending;
 		}
 
 		/// <summary>
@@ -42,7 +42,7 @@ protected override void OnLaunched(LaunchActivatedEventArgs e)
 #if DEBUG
 			if (System.Diagnostics.Debugger.IsAttached)
 			{
-				this.DebugSettings.EnableFrameRateCounter = true;
+				DebugSettings.EnableFrameRateCounter = true;
 			}
 #endif
 
@@ -61,7 +61,7 @@ protected override void OnLaunched(LaunchActivatedEventArgs e)
 
 				if (e.PreviousExecutionState == ApplicationExecutionState.Terminated)
 				{
-					//TODO: Load state from previously suspended application
+					// TODO: Load state from previously suspended application
 				}
 
 				// Place the frame in the current Window
@@ -75,6 +75,7 @@ protected override void OnLaunched(LaunchActivatedEventArgs e)
 				// parameter
 				rootFrame.Navigate(typeof(MainPage), e.Arguments);
 			}
+
 			// Ensure the current window is active
 			Window.Current.Activate();
 		}
@@ -96,10 +97,11 @@ void OnNavigationFailed(object sender, NavigationFailedEventArgs e)
 		/// </summary>
 		/// <param name="sender">The source of the suspend request.</param>
 		/// <param name="e">Details about the suspend request.</param>
-		private void OnSuspending(object sender, SuspendingEventArgs e)
+		void OnSuspending(object sender, SuspendingEventArgs e)
 		{
 			var deferral = e.SuspendingOperation.GetDeferral();
-			//TODO: Save application state and stop any background activity
+
+			// TODO: Save application state and stop any background activity
 			deferral.Complete();
 		}
 	}

samples/XCT.Sample.UWP/MainPage.xaml.cs

@@ -19,7 +19,7 @@ public sealed partial class MainPage
 	{
 		public MainPage()
 		{
-			this.InitializeComponent();
+			InitializeComponent();
 
 			LoadApplication(new Xamarin.CommunityToolkit.Sample.App());
 		}

samples/XCT.Sample.UWP/Properties/AssemblyInfo.cs

@@ -2,7 +2,7 @@
 using System.Runtime.CompilerServices;
 using System.Runtime.InteropServices;
 
-// General Information about an assembly is controlled through the following 
+// General Information about an assembly is controlled through the following
 // set of attributes. Change these attribute values to modify the information
 // associated with an assembly.
 [assembly: AssemblyTitle("Xamarin.CommunityToolkit.Sample.UWP")]
@@ -17,11 +17,11 @@
 // Version information for an assembly consists of the following four values:
 //
 //      Major Version
-//      Minor Version 
+//      Minor Version
 //      Build Number
 //      Revision
 //
-// You can specify all the values or you can default the Build and Revision Numbers 
+// You can specify all the values or you can default the Build and Revision Numbers
 // by using the '*' as shown below:
 // [assembly: AssemblyVersion("1.0.*")]
 [assembly: AssemblyVersion("1.0.0.0")]

samples/XCT.Sample.WPF/Properties/AssemblyInfo.cs

@@ -21,25 +21,19 @@
 // COM, set the ComVisible attribute to true on that type.
 [assembly: ComVisible(false)]
 
-//In order to begin building localizable applications, set
-//<UICulture>CultureYouAreCodingWith</UICulture> in your .csproj file
-//inside a <PropertyGroup>.  For example, if you are using US english
-//in your source files, set the <UICulture> to en-US.  Then uncomment
-//the NeutralResourceLanguage attribute below.  Update the "en-US" in
-//the line below to match the UICulture setting in the project file.
-
-//[assembly: NeutralResourcesLanguage("en-US", UltimateResourceFallbackLocation.Satellite)]
+// In order to begin building localizable applications, set
+// <UICulture>CultureYouAreCodingWith</UICulture> in your .csproj file
+// inside a <PropertyGroup>.  For example, if you are using US english
+// in your source files, set the <UICulture> to en-US.  Then uncomment
+// the NeutralResourceLanguage attribute below.  Update the "en-US" in
+// the line below to match the UICulture setting in the project file.
 
+// [assembly: NeutralResourcesLanguage("en-US", UltimateResourceFallbackLocation.Satellite)]
 
 [assembly: ThemeInfo(
-	ResourceDictionaryLocation.None, //where theme specific resource dictionaries are located
-									 //(used if a resource is not found in the page,
-									 // or application resource dictionaries)
-	ResourceDictionaryLocation.SourceAssembly //where the generic resource dictionary is located
-											  //(used if a resource is not found in the page,
-											  // app, or any theme specific resource dictionaries)
-)]
-
+	ResourceDictionaryLocation.None, // where theme specific resource dictionaries are located (used if a resource is not found in the page, or application resource dictionaries)
+	ResourceDictionaryLocation.SourceAssembly) // where the generic resource dictionary is located (used if a resource is not found in the page, app, or any theme specific resource dictionaries)
+]
 
 // Version information for an assembly consists of the following four values:
 //

samples/XCT.Sample/Helpers/MarkupExtensions.cs

@@ -3,14 +3,30 @@
 
 namespace Xamarin.CommunityToolkit.Sample
 {
-    public static class MarkupExtensions
-    {
-        public static TBindable Rainbow<TBindable>(this TBindable bindable) where TBindable : BindableObject { DebugRainbow.SetShowColors(bindable, true); return bindable; }
+	public static class MarkupExtensions
+	{
+		public static TBindable Rainbow<TBindable>(this TBindable bindable) where TBindable : BindableObject
+		{
+			DebugRainbow.SetShowColors(bindable, true);
+			return bindable;
+		}
 
-        public static TVisualElement Background<TVisualElement>(this TVisualElement visualElement, Color color) where TVisualElement : VisualElement { visualElement.BackgroundColor = color; return visualElement; }
+		public static TVisualElement Background<TVisualElement>(this TVisualElement visualElement, Color color) where TVisualElement : VisualElement
+		{
+			visualElement.BackgroundColor = color;
+			return visualElement;
+		}
 
-        public static TStackLayout Horizontal<TStackLayout>(this TStackLayout stackLayout) where TStackLayout : StackLayout { stackLayout.Orientation = StackOrientation.Horizontal; return stackLayout; }
-        
-		public static TStackLayout Vertical<TStackLayout>(this TStackLayout stackLayout) where TStackLayout : StackLayout { stackLayout.Orientation = StackOrientation.Vertical; return stackLayout; }
-    }
+		public static TStackLayout Horizontal<TStackLayout>(this TStackLayout stackLayout) where TStackLayout : StackLayout
+		{
+			stackLayout.Orientation = StackOrientation.Horizontal;
+			return stackLayout;
+		}
+
+		public static TStackLayout Vertical<TStackLayout>(this TStackLayout stackLayout) where TStackLayout : StackLayout
+		{
+			stackLayout.Orientation = StackOrientation.Vertical;
+			return stackLayout;
+		}
+	}
 }

samples/XCT.Sample/Pages/Behaviors/RequiredStringValidationBehaviorPage.xaml.cs

@@ -1,4 +1,4 @@
-using Xamarin.Forms.Xaml;
+using Xamarin.Forms.Xaml;
 
 namespace Xamarin.CommunityToolkit.Sample.Pages.Behaviors
 {

samples/XCT.Sample/Pages/Views/UniformGridPage.xaml.cs

@@ -1,6 +1,6 @@
 namespace Xamarin.CommunityToolkit.Sample.Pages.Views
 {
-	public partial class UniformGridPage 
+	public partial class UniformGridPage
 	{
 		public UniformGridPage() => InitializeComponent();
 	}

samples/XCT.Sample/ViewModels/Effects/EffectsGalleryViewModel.cs

@@ -12,32 +12,27 @@ public class EffectsGalleryViewModel : BaseGalleryViewModel
 			new SectionModel(
 				typeof(SafeAreaEffectPage),
 				nameof(SafeAreaEffect),
-				"The SafeAreaEffect is an effectwill help to make sure that content isn't clipped by rounded device corners, the home indicator, or the sensor housing on an iPhone X (or alike)"
-				),
+				"The SafeAreaEffect is an effectwill help to make sure that content isn't clipped by rounded device corners, the home indicator, or the sensor housing on an iPhone X (or alike)"),
 
 			new SectionModel(
 				typeof(RemoveBorderEffectPage),
 				nameof(RemoveBorderEffect),
-				"The RemoveBorderEffect is an effect that will remove the border from an Entry on iOS and the underline from an entry on Android"
-				),
+				"The RemoveBorderEffect is an effect that will remove the border from an Entry on iOS and the underline from an entry on Android"),
 
 			new SectionModel(
 				typeof(SelectAllTextEffectPage),
 				nameof(SelectAllTextEffect),
-				"The SelectAllTextEffect is an effect that will select all text in an Entry / Editor when it becomes focussed"
-				),
+				"The SelectAllTextEffect is an effect that will select all text in an Entry / Editor when it becomes focussed"),
 
 			new SectionModel(
 				typeof(IconTintColorEffectPage),
 				nameof(IconTintColorEffect),
-				"With the IconTintColorEffect you set the tint color of an Image or ImageButton."
-				),
+				"With the IconTintColorEffect you set the tint color of an Image or ImageButton."),
 
 			new SectionModel(
 				typeof(TouchEffectPage),
 				nameof(TouchEffect),
-				"The TouchEffect is an effect that allows changing the view's appearance depending on the touch state (normal, pressed, hovered). Also, it allows to handle long presses."
-				),
+				"The TouchEffect is an effect that allows changing the view's appearance depending on the touch state (normal, pressed, hovered). Also, it allows to handle long presses."),
 		};
 	}
 }