Update AbsoluteLayout Flags Extensions (#216)

Author: TheCodeTraveler

samples/CommunityToolkit.Maui.Markup.Sample/Pages/SettingsPage.cs

@@ -11,6 +11,7 @@ public SettingsPage(SettingsViewModel settingsViewModel) : base(settingsViewMode
 			Children =
 			{
 				new Image().Source("dotnet_bot.png").Opacity(0.25).IsOpaque(false).Aspect(Aspect.AspectFit)
+					.ClearLayoutFlags()
 					.LayoutFlags(AbsoluteLayoutFlags.SizeProportional | AbsoluteLayoutFlags.PositionProportional)
 					.LayoutBounds(0.5, 0.5, 0.5, 0.5)
 					.AutomationIsInAccessibleTree(false),
@@ -27,7 +28,7 @@ public SettingsPage(SettingsViewModel settingsViewModel) : base(settingsViewMode
 				new Entry { Keyboard = Keyboard.Numeric }
 					.BackgroundColor(Colors.White)
 					.Placeholder($"Provide a value between {SettingsService.MinimumStoriesToFetch} and {SettingsService.MaximumStoriesToFetch}", Colors.Grey)
-					.LayoutFlags(AbsoluteLayoutFlags.XProportional | AbsoluteLayoutFlags.WidthProportional)
+					.LayoutFlags(AbsoluteLayoutFlags.XProportional, AbsoluteLayoutFlags.WidthProportional)
 					.LayoutBounds(0.5, 45, 0.8, 40)
 					.Behaviors(new NumericValidationBehavior
 					{

src/CommunityToolkit.Maui.Markup.UnitTests/AbsoluteLayoutExtensionsTests.cs

@@ -12,6 +12,16 @@ public void LayoutFlags() => TestPropertiesSet(
 		b => b.LayoutFlags(AbsoluteLayoutFlags.PositionProportional),
 		(AbsoluteLayout.LayoutFlagsProperty, AbsoluteLayoutFlags.PositionProportional));
 
+	[Test]
+	public void MultipleLayoutFlagsUsingBooleanLogic() => TestPropertiesSet(
+		b => b.LayoutFlags(AbsoluteLayoutFlags.PositionProportional | AbsoluteLayoutFlags.XProportional),
+		(AbsoluteLayout.LayoutFlagsProperty, AbsoluteLayoutFlags.PositionProportional | AbsoluteLayoutFlags.XProportional));
+
+	[Test]
+	public void MultipleLayoutFlagsUsingParams() => TestPropertiesSet(
+		b => b.LayoutFlags(AbsoluteLayoutFlags.PositionProportional, AbsoluteLayoutFlags.XProportional),
+		(AbsoluteLayout.LayoutFlagsProperty, AbsoluteLayoutFlags.PositionProportional | AbsoluteLayoutFlags.XProportional));
+
 	[Test]
 	public void LayoutBoundsPositionOnlyDouble() => TestPropertiesSet(
 		b =>
@@ -67,4 +77,20 @@ public void LayoutBoundsAllDouble() => TestPropertiesSet(
 			b.LayoutBounds(100, 100, 100, 100);
 		},
 		(AbsoluteLayout.LayoutBoundsProperty, new Rect(100, 100, 100, 100)));
+
+	// Cannot use TestPropertiesSet() because ClearLayoutFlags sets AbsoluteLayout.LayoutFlagsProperty to its default 
+	[Test]
+	public void ClearLayoutFlags()
+	{
+		var label = new Label().ClearLayoutFlags();
+		Assert.AreEqual(AbsoluteLayoutFlags.None, label.GetPropertyIfSet(AbsoluteLayout.LayoutFlagsProperty, (AbsoluteLayoutFlags)(-1)));
+	}
+
+	// Cannot use TestPropertiesSet() because ClearLayoutFlags sets AbsoluteLayout.LayoutFlagsProperty to its default 
+	[Test]
+	public void ClearLayoutFlagsAfterSettingLayoutFlags()
+	{
+		var label = new Label().LayoutFlags(AbsoluteLayoutFlags.XProportional).ClearLayoutFlags();
+		Assert.AreEqual(AbsoluteLayoutFlags.None, label.GetPropertyIfSet(AbsoluteLayout.LayoutFlagsProperty, AbsoluteLayoutFlags.XProportional));
+	}
 }

src/CommunityToolkit.Maui.Markup/AbsoluteLayoutExtensions.cs

@@ -7,9 +7,25 @@ namespace CommunityToolkit.Maui.Markup;
 /// </summary>
 public static class AbsoluteLayoutExtensions
 {
+	/// <summary>
+	/// Removes all <see cref="AbsoluteLayoutFlags"/>, reverting to the default configuraion of <see cref="AbsoluteLayoutFlags.None"/>.
+	/// </summary>
+	/// <typeparam name="TBindable"></typeparam>
+	/// <param name="bindable"></param>
+	/// <returns></returns>
+	public static TBindable ClearLayoutFlags<TBindable>(this TBindable bindable) where TBindable : BindableObject
+	{
+		AbsoluteLayout.SetLayoutFlags(bindable, AbsoluteLayoutFlags.None);
+		return bindable;
+	}
+
 	/// <summary>
 	/// Set an <see cref="AbsoluteLayoutFlags"/> that indicates whether the layout bounds position and size values for a child are proportional to the size of the <see cref="AbsoluteLayout"/>.
+	/// Appends <paramref name="flag"/> to existing <see cref="AbsoluteLayoutFlags"/>
 	/// </summary>
+	/// <remarks>
+	/// To clear existing <see cref="AbsoluteLayoutFlags"/>, use <see cref="ClearLayoutFlags{TBindable}(TBindable)"/>
+	/// </remarks>
 	/// <typeparam name="TBindable"></typeparam>
 	/// <param name="bindable"></param>
 	/// <param name="flag"></param>
@@ -20,6 +36,29 @@ public static TBindable LayoutFlags<TBindable>(this TBindable bindable, Absolute
 		return bindable;
 	}
 
+	/// <summary>
+	/// Set an <see cref="AbsoluteLayoutFlags"/> that indicates whether the layout bounds position and size values for a child are proportional to the size of the <see cref="AbsoluteLayout"/>.
+	/// </summary>
+	/// <remarks>
+	/// To clear existing <see cref="AbsoluteLayoutFlags"/>, use <see cref="ClearLayoutFlags{TBindable}(TBindable)"/>
+	/// </remarks>
+	/// <typeparam name="TBindable"></typeparam>
+	/// <param name="bindable"></param>
+	/// <param name="flags"></param>
+	/// <returns></returns>
+	public static TBindable LayoutFlags<TBindable>(this TBindable bindable, params AbsoluteLayoutFlags[] flags) where TBindable : BindableObject
+	{
+		var newFlags = AbsoluteLayoutFlags.None;
+
+		foreach(var flag in flags)
+		{
+			newFlags |= flag;
+		}
+
+		AbsoluteLayout.SetLayoutFlags(bindable, newFlags);
+		return bindable;
+	}
+
 	/// <summary> 
 	/// Set the position and size of a <see cref="View"/> in an <see cref="AbsoluteLayout"/>
 	/// </summary>