From bdb385a81ab08a1cf19ffc3e3041041b9cf53a13 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Javier=20Su=C3=A1rez?= Date: Fri, 1 Mar 2024 09:44:05 +0100 Subject: [PATCH 01/22] Added pending inline comments to Page class --- .../WindowsSpecific/Page.cs | 29 +++++-- .../PlatformConfiguration/iOSSpecific/Page.cs | 87 ++++++++++++++++--- 2 files changed, 98 insertions(+), 18 deletions(-) diff --git a/src/Controls/src/Core/PlatformConfiguration/WindowsSpecific/Page.cs b/src/Controls/src/Core/PlatformConfiguration/WindowsSpecific/Page.cs index ebb18abd7b41..541b80e7f809 100644 --- a/src/Controls/src/Core/PlatformConfiguration/WindowsSpecific/Page.cs +++ b/src/Controls/src/Core/PlatformConfiguration/WindowsSpecific/Page.cs @@ -49,30 +49,49 @@ public static IPlatformElementConfiguration SetToolbarPla #region ToolbarDynamicOverflowEnabled - /// Bindable property for attached property ToolbarDynamicOverflowEnabled. + /// + /// Indicates whether toolbar items automatically move to the overflow menu when space is limited. + /// public static readonly BindableProperty ToolbarDynamicOverflowEnabledProperty = BindableProperty.CreateAttached("ToolbarDynamicOverflowEnabled", typeof(bool), typeof(FormsElement), true); - /// + /// + /// Gets a value that indicates whether toolbar items automatically move to the overflow menu when space is limited. + /// + /// A page, the VisualElement that occupies the entire screen. + /// True if toolbar items automatically move to the overflow menu when space is limited; otherwise, false. public static bool GetToolbarDynamicOverflowEnabled(BindableObject element) { return (bool)element.GetValue(ToolbarDynamicOverflowEnabledProperty); } - /// + /// + /// Sets a value that indicates whether toolbar items automatically move to the overflow menu when space is limited. + /// + /// A page, the VisualElement that occupies the entire screen. + /// A value that indicates whether toolbar items automatically move to the overflow menu when space is limited public static void SetToolbarDynamicOverflowEnabled(BindableObject element, bool value) { element.SetValue(ToolbarDynamicOverflowEnabledProperty, value); } - /// + /// + /// Gets a value that indicates whether toolbar items automatically move to the overflow menu when space is limited. + /// + /// The platform specific configuration that contains the element on which to perform the operation. + /// True if toolbar items automatically move to the overflow menu when space is limited; otherwise, false. public static bool GetToolbarDynamicOverflowEnabled(this IPlatformElementConfiguration config) { return (bool)config.Element.GetValue(ToolbarDynamicOverflowEnabledProperty); } - /// + /// + /// Sets a value that indicates whether toolbar items automatically move to the overflow menu when space is limited. + /// + /// The platform specific configuration that contains the element on which to perform the operation. + /// A value that indicates whether toolbar items automatically move to the overflow menu when space is limited + /// True if toolbar items automatically move to the overflow menu when space is limited; otherwise, false. public static IPlatformElementConfiguration SetToolbarDynamicOverflowEnabled( this IPlatformElementConfiguration config, bool value) { diff --git a/src/Controls/src/Core/PlatformConfiguration/iOSSpecific/Page.cs b/src/Controls/src/Core/PlatformConfiguration/iOSSpecific/Page.cs index 79b0ce75e475..ab50f464b96d 100644 --- a/src/Controls/src/Core/PlatformConfiguration/iOSSpecific/Page.cs +++ b/src/Controls/src/Core/PlatformConfiguration/iOSSpecific/Page.cs @@ -71,33 +71,52 @@ public static IPlatformElementConfiguration SetPreferredStatu return config; } - /// Bindable property for attached property UseSafeArea. + /// + /// Controls whether padding values are overridden with the safe area insets. + /// #if MACCATALYST public static readonly BindableProperty UseSafeAreaProperty = BindableProperty.Create("UseSafeArea", typeof(bool), typeof(Page), true); #else public static readonly BindableProperty UseSafeAreaProperty = BindableProperty.Create("UseSafeArea", typeof(bool), typeof(Page), false); #endif - /// + /// + /// Gets a Boolean value that tells whether padding values are overridden with values that conform to the safe area on the device. + /// + /// The element whose safe area behavior to get. + /// A Boolean value that tells whether padding values are overridden or not. public static bool GetUseSafeArea(BindableObject element) { return (bool)element.GetValue(UseSafeAreaProperty); } - /// + /// + /// Sets a value that controls whether padding values are overridden with the safe area insets. + /// + /// The element whose safe area use behavior to set. + /// The new safe area inset behavior. public static void SetUseSafeArea(BindableObject element, bool value) { element.SetValue(UseSafeAreaProperty, value); } - /// + /// + /// Sets a value that controls whether padding values are overridden with the safe area insets. + /// + /// The element whose safe area behavior to get. + /// The new safe area inset behavior. + /// public static IPlatformElementConfiguration SetUseSafeArea(this IPlatformElementConfiguration config, bool value) { SetUseSafeArea(config.Element, value); return config; } - /// + /// + /// Returns a Boolean value that tells whether the padding is overridden with the safe area. + /// + /// The element whose safe area behavior to get. + /// A Boolean value that tells whether the padding is overridden with the safe area. public static bool UsingSafeArea(this IPlatformElementConfiguration config) { return GetUseSafeArea(config.Element); @@ -161,29 +180,54 @@ public static IPlatformElementConfiguration SetSafeAreaInsets return config; } - /// Bindable property for . + /// + /// Defines the modal presentation style of the Page. + /// public static readonly BindableProperty ModalPresentationStyleProperty = BindableProperty.Create(nameof(ModalPresentationStyle), typeof(UIModalPresentationStyle), typeof(Page), UIModalPresentationStyle.FullScreen); - /// + /// + /// Gets the modal presentation style of the Page. + /// + /// The platform specific configuration that contains the element on which to perform the operation. + /// The modal presentation style. public static UIModalPresentationStyle ModalPresentationStyle(this IPlatformElementConfiguration config) { return GetModalPresentationStyle(config.Element); } - /// + /// + /// Sets the modal presentation style. + /// + /// The platform specific configuration that contains the element on which to perform the operation. + /// The modal presentation style. + /// The platform specific configuration that contains the element on which to perform the operation. public static IPlatformElementConfiguration SetModalPresentationStyle(this IPlatformElementConfiguration config, UIModalPresentationStyle value) { SetModalPresentationStyle(config.Element, value); return config; } - /// + /// + /// Gets the current value of the UIModalPresentationStyle enumeration that's applied to the Page. + /// + /// A page, the VisualElement that occupies the entire screen. + /// The current value of the UIModalPresentationStyle enumeration that's applied to the Page. public static UIModalPresentationStyle GetModalPresentationStyle(BindableObject element) { return (UIModalPresentationStyle)element.GetValue(ModalPresentationStyleProperty); } + /// + /// Sets the modal presentation style on a Page by specifying one of the following UIModalPresentationStyle enumeration values: + /// - FullScreen, which sets the modal presentation style to encompass the whole screen.By default, modal pages are displayed using this presentation style. + /// - FormSheet, which sets the modal presentation style to be centered on and smaller than the screen. + /// - Automatic, which sets the modal presentation style to the default chosen by the system. For most view controllers, UIKit maps this to UIModalPresentationStyle.PageSheet, but some system view controllers may map it to a different style. + /// - OverFullScreen, which sets the modal presentation style to cover the screen. + /// - PageSheet, which sets the modal presentation style to cover the underlying content. + /// + /// A page, the VisualElement that occupies the entire screen. + /// The modal presentation style. static void SetModalPresentationStyle(BindableObject element, UIModalPresentationStyle value) { element.SetValue(ModalPresentationStyleProperty, value); @@ -193,25 +237,42 @@ static void SetModalPresentationStyle(BindableObject element, UIModalPresentatio public static readonly BindableProperty PrefersHomeIndicatorAutoHiddenProperty = BindableProperty.Create(nameof(PrefersHomeIndicatorAutoHidden), typeof(bool), typeof(Page), false); - /// + /// + /// Gets a Boolean that indicates whether is allowed to hide the visual indicator for returning to the Home Screen. + /// + /// A page, the VisualElement that occupies the entire screen. + /// public static bool GetPrefersHomeIndicatorAutoHidden(BindableObject element) { return (bool)element.GetValue(PrefersHomeIndicatorAutoHiddenProperty); } - /// + /// + /// Sets a Boolean that indicates whether is allowed to hide the visual indicator for returning to the Home Screen. + /// + /// A page, the VisualElement that occupies the entire screen. + /// True when hide the home indicator, or false if you want the indicator to show at all times. public static void SetPrefersHomeIndicatorAutoHidden(BindableObject element, bool value) { element.SetValue(PrefersHomeIndicatorAutoHiddenProperty, value); } - /// + /// + /// Gets a Boolean that indicates whether is allowed to hide the visual indicator for returning to the Home Screen. + /// + /// The platform specific configuration that contains the element on which to perform the operation. + /// True when hide the home indicator, or false if you want the indicator to show at all times. public static bool PrefersHomeIndicatorAutoHidden(this IPlatformElementConfiguration config) { return GetPrefersHomeIndicatorAutoHidden(config.Element); } - /// + /// + /// Sets a Boolean that indicates whether is allowed to hide the visual indicator for returning to the Home Screen. + /// + /// The platform specific configuration that contains the element on which to perform the operation. + /// True when hide the home indicator, or false if you want the indicator to show at all times. + /// public static IPlatformElementConfiguration SetPrefersHomeIndicatorAutoHidden(this IPlatformElementConfiguration config, bool value) { SetPrefersHomeIndicatorAutoHidden(config.Element, value); From 14123e8e43be2fb559b5f797d7b90150da43b407 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Javier=20Su=C3=A1rez?= Date: Tue, 5 Mar 2024 15:39:22 +0100 Subject: [PATCH 02/22] Update src/Controls/src/Core/PlatformConfiguration/iOSSpecific/Page.cs Co-authored-by: Juan Diego Herrera --- src/Controls/src/Core/PlatformConfiguration/iOSSpecific/Page.cs | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/Controls/src/Core/PlatformConfiguration/iOSSpecific/Page.cs b/src/Controls/src/Core/PlatformConfiguration/iOSSpecific/Page.cs index ab50f464b96d..ea24a075e4e3 100644 --- a/src/Controls/src/Core/PlatformConfiguration/iOSSpecific/Page.cs +++ b/src/Controls/src/Core/PlatformConfiguration/iOSSpecific/Page.cs @@ -81,7 +81,7 @@ public static IPlatformElementConfiguration SetPreferredStatu #endif /// - /// Gets a Boolean value that tells whether padding values are overridden with values that conform to the safe area on the device. + /// Gets a value that indicates whether padding values are overridden with values that conform to the safe area on the device. /// /// The element whose safe area behavior to get. /// A Boolean value that tells whether padding values are overridden or not. From 3a1007abf92471e28922bccc11fb6e3eb1ec1ad4 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Javier=20Su=C3=A1rez?= Date: Tue, 5 Mar 2024 15:44:26 +0100 Subject: [PATCH 03/22] More changes --- .../src/Core/PlatformConfiguration/WindowsSpecific/Page.cs | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/src/Controls/src/Core/PlatformConfiguration/WindowsSpecific/Page.cs b/src/Controls/src/Core/PlatformConfiguration/WindowsSpecific/Page.cs index 541b80e7f809..8b4b02152bf3 100644 --- a/src/Controls/src/Core/PlatformConfiguration/WindowsSpecific/Page.cs +++ b/src/Controls/src/Core/PlatformConfiguration/WindowsSpecific/Page.cs @@ -60,7 +60,7 @@ public static IPlatformElementConfiguration SetToolbarPla /// Gets a value that indicates whether toolbar items automatically move to the overflow menu when space is limited. /// /// A page, the VisualElement that occupies the entire screen. - /// True if toolbar items automatically move to the overflow menu when space is limited; otherwise, false. + /// if toolbar items automatically move to the overflow menu when space is limited; otherwise, . public static bool GetToolbarDynamicOverflowEnabled(BindableObject element) { return (bool)element.GetValue(ToolbarDynamicOverflowEnabledProperty); @@ -80,7 +80,7 @@ public static void SetToolbarDynamicOverflowEnabled(BindableObject element, bool /// Gets a value that indicates whether toolbar items automatically move to the overflow menu when space is limited. /// /// The platform specific configuration that contains the element on which to perform the operation. - /// True if toolbar items automatically move to the overflow menu when space is limited; otherwise, false. + /// if toolbar items automatically move to the overflow menu when space is limited; otherwise, . public static bool GetToolbarDynamicOverflowEnabled(this IPlatformElementConfiguration config) { return (bool)config.Element.GetValue(ToolbarDynamicOverflowEnabledProperty); @@ -91,7 +91,7 @@ public static bool GetToolbarDynamicOverflowEnabled(this IPlatformElementConfigu /// /// The platform specific configuration that contains the element on which to perform the operation. /// A value that indicates whether toolbar items automatically move to the overflow menu when space is limited - /// True if toolbar items automatically move to the overflow menu when space is limited; otherwise, false. + /// if toolbar items automatically move to the overflow menu when space is limited; otherwise, . public static IPlatformElementConfiguration SetToolbarDynamicOverflowEnabled( this IPlatformElementConfiguration config, bool value) { From 33731dcac0834405114341a9b23dfe24e2fda89b Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Javier=20Su=C3=A1rez?= Date: Tue, 12 Mar 2024 12:29:00 +0100 Subject: [PATCH 04/22] Changes from PR feedback --- .../src/Core/PlatformConfiguration/WindowsSpecific/Page.cs | 4 ++-- .../src/Core/PlatformConfiguration/iOSSpecific/Page.cs | 2 +- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/src/Controls/src/Core/PlatformConfiguration/WindowsSpecific/Page.cs b/src/Controls/src/Core/PlatformConfiguration/WindowsSpecific/Page.cs index 8b4b02152bf3..3b47b0691405 100644 --- a/src/Controls/src/Core/PlatformConfiguration/WindowsSpecific/Page.cs +++ b/src/Controls/src/Core/PlatformConfiguration/WindowsSpecific/Page.cs @@ -59,7 +59,7 @@ public static IPlatformElementConfiguration SetToolbarPla /// /// Gets a value that indicates whether toolbar items automatically move to the overflow menu when space is limited. /// - /// A page, the VisualElement that occupies the entire screen. + /// A page, the that occupies the entire screen. /// if toolbar items automatically move to the overflow menu when space is limited; otherwise, . public static bool GetToolbarDynamicOverflowEnabled(BindableObject element) { @@ -69,7 +69,7 @@ public static bool GetToolbarDynamicOverflowEnabled(BindableObject element) /// /// Sets a value that indicates whether toolbar items automatically move to the overflow menu when space is limited. /// - /// A page, the VisualElement that occupies the entire screen. + /// A page, the that occupies the entire screen. /// A value that indicates whether toolbar items automatically move to the overflow menu when space is limited public static void SetToolbarDynamicOverflowEnabled(BindableObject element, bool value) { diff --git a/src/Controls/src/Core/PlatformConfiguration/iOSSpecific/Page.cs b/src/Controls/src/Core/PlatformConfiguration/iOSSpecific/Page.cs index ea24a075e4e3..dc86222447e9 100644 --- a/src/Controls/src/Core/PlatformConfiguration/iOSSpecific/Page.cs +++ b/src/Controls/src/Core/PlatformConfiguration/iOSSpecific/Page.cs @@ -84,7 +84,7 @@ public static IPlatformElementConfiguration SetPreferredStatu /// Gets a value that indicates whether padding values are overridden with values that conform to the safe area on the device. /// /// The element whose safe area behavior to get. - /// A Boolean value that tells whether padding values are overridden or not. + /// true if the padding values are overridden; otherwise, false. public static bool GetUseSafeArea(BindableObject element) { return (bool)element.GetValue(UseSafeAreaProperty); From 07174b571b95006988b88a5d5c66c5934b3d548e Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Javier=20Su=C3=A1rez?= Date: Tue, 12 Mar 2024 12:29:20 +0100 Subject: [PATCH 05/22] Update src/Controls/src/Core/PlatformConfiguration/iOSSpecific/Page.cs Co-authored-by: Juan Diego Herrera --- src/Controls/src/Core/PlatformConfiguration/iOSSpecific/Page.cs | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/Controls/src/Core/PlatformConfiguration/iOSSpecific/Page.cs b/src/Controls/src/Core/PlatformConfiguration/iOSSpecific/Page.cs index dc86222447e9..e8376b3e256c 100644 --- a/src/Controls/src/Core/PlatformConfiguration/iOSSpecific/Page.cs +++ b/src/Controls/src/Core/PlatformConfiguration/iOSSpecific/Page.cs @@ -248,7 +248,7 @@ public static bool GetPrefersHomeIndicatorAutoHidden(BindableObject element) } /// - /// Sets a Boolean that indicates whether is allowed to hide the visual indicator for returning to the Home Screen. + /// Sets a value that indicates whether the visual indicator should hide upon returning to the home screen. /// /// A page, the VisualElement that occupies the entire screen. /// True when hide the home indicator, or false if you want the indicator to show at all times. From 957f822475fc8664a136ab6a998e39557987448a Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Javier=20Su=C3=A1rez?= Date: Tue, 12 Mar 2024 12:29:29 +0100 Subject: [PATCH 06/22] Update src/Controls/src/Core/PlatformConfiguration/iOSSpecific/Page.cs Co-authored-by: Juan Diego Herrera --- src/Controls/src/Core/PlatformConfiguration/iOSSpecific/Page.cs | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/Controls/src/Core/PlatformConfiguration/iOSSpecific/Page.cs b/src/Controls/src/Core/PlatformConfiguration/iOSSpecific/Page.cs index e8376b3e256c..dc023e5c068b 100644 --- a/src/Controls/src/Core/PlatformConfiguration/iOSSpecific/Page.cs +++ b/src/Controls/src/Core/PlatformConfiguration/iOSSpecific/Page.cs @@ -83,7 +83,7 @@ public static IPlatformElementConfiguration SetPreferredStatu /// /// Gets a value that indicates whether padding values are overridden with values that conform to the safe area on the device. /// - /// The element whose safe area behavior to get. + /// The element to get the safe area behavior from. /// true if the padding values are overridden; otherwise, false. public static bool GetUseSafeArea(BindableObject element) { From f802bee898441eaed32ac072cea13f5f60091e95 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Javier=20Su=C3=A1rez?= Date: Tue, 12 Mar 2024 12:29:37 +0100 Subject: [PATCH 07/22] Update src/Controls/src/Core/PlatformConfiguration/iOSSpecific/Page.cs Co-authored-by: Juan Diego Herrera --- src/Controls/src/Core/PlatformConfiguration/iOSSpecific/Page.cs | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/Controls/src/Core/PlatformConfiguration/iOSSpecific/Page.cs b/src/Controls/src/Core/PlatformConfiguration/iOSSpecific/Page.cs index dc023e5c068b..e93efca0c562 100644 --- a/src/Controls/src/Core/PlatformConfiguration/iOSSpecific/Page.cs +++ b/src/Controls/src/Core/PlatformConfiguration/iOSSpecific/Page.cs @@ -238,7 +238,7 @@ static void SetModalPresentationStyle(BindableObject element, UIModalPresentatio BindableProperty.Create(nameof(PrefersHomeIndicatorAutoHidden), typeof(bool), typeof(Page), false); /// - /// Gets a Boolean that indicates whether is allowed to hide the visual indicator for returning to the Home Screen. + /// Gets a value that indicates whether the visual indicator should hide upon returning to the home screen. /// /// A page, the VisualElement that occupies the entire screen. /// From 65f22eb9b26c5fa110c896911b3b298a9e167084 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Javier=20Su=C3=A1rez?= Date: Tue, 12 Mar 2024 12:31:16 +0100 Subject: [PATCH 08/22] More changes --- .../src/Core/PlatformConfiguration/iOSSpecific/Page.cs | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/src/Controls/src/Core/PlatformConfiguration/iOSSpecific/Page.cs b/src/Controls/src/Core/PlatformConfiguration/iOSSpecific/Page.cs index dc86222447e9..39b932a50b96 100644 --- a/src/Controls/src/Core/PlatformConfiguration/iOSSpecific/Page.cs +++ b/src/Controls/src/Core/PlatformConfiguration/iOSSpecific/Page.cs @@ -251,7 +251,7 @@ public static bool GetPrefersHomeIndicatorAutoHidden(BindableObject element) /// Sets a Boolean that indicates whether is allowed to hide the visual indicator for returning to the Home Screen. /// /// A page, the VisualElement that occupies the entire screen. - /// True when hide the home indicator, or false if you want the indicator to show at all times. + /// true if hide the home indicator; otherwise, false. public static void SetPrefersHomeIndicatorAutoHidden(BindableObject element, bool value) { element.SetValue(PrefersHomeIndicatorAutoHiddenProperty, value); @@ -261,7 +261,7 @@ public static void SetPrefersHomeIndicatorAutoHidden(BindableObject element, boo /// Gets a Boolean that indicates whether is allowed to hide the visual indicator for returning to the Home Screen. /// /// The platform specific configuration that contains the element on which to perform the operation. - /// True when hide the home indicator, or false if you want the indicator to show at all times. + /// true if hide the home indicator; otherwise, false. public static bool PrefersHomeIndicatorAutoHidden(this IPlatformElementConfiguration config) { return GetPrefersHomeIndicatorAutoHidden(config.Element); @@ -271,7 +271,7 @@ public static bool PrefersHomeIndicatorAutoHidden(this IPlatformElementConfigura /// Sets a Boolean that indicates whether is allowed to hide the visual indicator for returning to the Home Screen. /// /// The platform specific configuration that contains the element on which to perform the operation. - /// True when hide the home indicator, or false if you want the indicator to show at all times. + /// true if hide the home indicator; otherwise, false. /// public static IPlatformElementConfiguration SetPrefersHomeIndicatorAutoHidden(this IPlatformElementConfiguration config, bool value) { From e226374edde2ad8cbdd9e1098cc1fe03281b457e Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Javier=20Su=C3=A1rez?= Date: Tue, 12 Mar 2024 12:41:27 +0100 Subject: [PATCH 09/22] More changes --- .../Core/PlatformConfiguration/iOSSpecific/Page.cs | 13 ++++--------- 1 file changed, 4 insertions(+), 9 deletions(-) diff --git a/src/Controls/src/Core/PlatformConfiguration/iOSSpecific/Page.cs b/src/Controls/src/Core/PlatformConfiguration/iOSSpecific/Page.cs index 8ec4886465ff..1141e8c97404 100644 --- a/src/Controls/src/Core/PlatformConfiguration/iOSSpecific/Page.cs +++ b/src/Controls/src/Core/PlatformConfiguration/iOSSpecific/Page.cs @@ -181,13 +181,13 @@ public static IPlatformElementConfiguration SetSafeAreaInsets } /// - /// Defines the modal presentation style of the Page. + /// Defines the modal presentation style of the . /// public static readonly BindableProperty ModalPresentationStyleProperty = BindableProperty.Create(nameof(ModalPresentationStyle), typeof(UIModalPresentationStyle), typeof(Page), UIModalPresentationStyle.FullScreen); /// - /// Gets the modal presentation style of the Page. + /// Gets the modal presentation style of the . /// /// The platform specific configuration that contains the element on which to perform the operation. /// The modal presentation style. @@ -209,7 +209,7 @@ public static IPlatformElementConfiguration SetModalPresentat } /// - /// Gets the current value of the UIModalPresentationStyle enumeration that's applied to the Page. + /// Gets the current value of the UIModalPresentationStyle enumeration that's applied to the . /// /// A page, the VisualElement that occupies the entire screen. /// The current value of the UIModalPresentationStyle enumeration that's applied to the Page. @@ -219,12 +219,7 @@ public static UIModalPresentationStyle GetModalPresentationStyle(BindableObject } /// - /// Sets the modal presentation style on a Page by specifying one of the following UIModalPresentationStyle enumeration values: - /// - FullScreen, which sets the modal presentation style to encompass the whole screen.By default, modal pages are displayed using this presentation style. - /// - FormSheet, which sets the modal presentation style to be centered on and smaller than the screen. - /// - Automatic, which sets the modal presentation style to the default chosen by the system. For most view controllers, UIKit maps this to UIModalPresentationStyle.PageSheet, but some system view controllers may map it to a different style. - /// - OverFullScreen, which sets the modal presentation style to cover the screen. - /// - PageSheet, which sets the modal presentation style to cover the underlying content. + /// Sets the modal presentation style on a Page. /// /// A page, the VisualElement that occupies the entire screen. /// The modal presentation style. From d9fe8b234d888528fff0f9db17a5fa2172b8acd2 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Javier=20Su=C3=A1rez?= Date: Tue, 12 Mar 2024 12:44:16 +0100 Subject: [PATCH 10/22] more changes --- .../src/Core/PlatformConfiguration/iOSSpecific/Page.cs | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/src/Controls/src/Core/PlatformConfiguration/iOSSpecific/Page.cs b/src/Controls/src/Core/PlatformConfiguration/iOSSpecific/Page.cs index 1141e8c97404..ea4fba40ac1c 100644 --- a/src/Controls/src/Core/PlatformConfiguration/iOSSpecific/Page.cs +++ b/src/Controls/src/Core/PlatformConfiguration/iOSSpecific/Page.cs @@ -116,7 +116,7 @@ public static IPlatformElementConfiguration SetUseSafeArea(th /// Returns a Boolean value that tells whether the padding is overridden with the safe area. /// /// The element whose safe area behavior to get. - /// A Boolean value that tells whether the padding is overridden with the safe area. + /// true if the padding is overridden with the safe area; otherwise, false. public static bool UsingSafeArea(this IPlatformElementConfiguration config) { return GetUseSafeArea(config.Element); @@ -197,7 +197,7 @@ public static UIModalPresentationStyle ModalPresentationStyle(this IPlatformElem } /// - /// Sets the modal presentation style. + /// Sets the modal presentation style of the . /// /// The platform specific configuration that contains the element on which to perform the operation. /// The modal presentation style. @@ -209,7 +209,7 @@ public static IPlatformElementConfiguration SetModalPresentat } /// - /// Gets the current value of the UIModalPresentationStyle enumeration that's applied to the . + /// Gets the current value of the enumeration that's applied to the . /// /// A page, the VisualElement that occupies the entire screen. /// The current value of the UIModalPresentationStyle enumeration that's applied to the Page. From 04baaf2fd07e01ff942449a4919771765de90e38 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Javier=20Su=C3=A1rez?= Date: Wed, 13 Mar 2024 13:41:18 +0100 Subject: [PATCH 11/22] Update src/Controls/src/Core/PlatformConfiguration/iOSSpecific/Page.cs Co-authored-by: Juan Diego Herrera --- src/Controls/src/Core/PlatformConfiguration/iOSSpecific/Page.cs | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/Controls/src/Core/PlatformConfiguration/iOSSpecific/Page.cs b/src/Controls/src/Core/PlatformConfiguration/iOSSpecific/Page.cs index ea4fba40ac1c..f0741afb4c4a 100644 --- a/src/Controls/src/Core/PlatformConfiguration/iOSSpecific/Page.cs +++ b/src/Controls/src/Core/PlatformConfiguration/iOSSpecific/Page.cs @@ -93,7 +93,7 @@ public static bool GetUseSafeArea(BindableObject element) /// /// Sets a value that controls whether padding values are overridden with the safe area insets. /// - /// The element whose safe area use behavior to set. + /// The element whose safe area behavior will be set. /// The new safe area inset behavior. public static void SetUseSafeArea(BindableObject element, bool value) { From 965cdceb1c0a2a3f8d3a04f0c64b2d3a2f1d06d3 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Javier=20Su=C3=A1rez?= Date: Wed, 13 Mar 2024 13:41:33 +0100 Subject: [PATCH 12/22] Update src/Controls/src/Core/PlatformConfiguration/iOSSpecific/Page.cs Co-authored-by: Juan Diego Herrera --- src/Controls/src/Core/PlatformConfiguration/iOSSpecific/Page.cs | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/Controls/src/Core/PlatformConfiguration/iOSSpecific/Page.cs b/src/Controls/src/Core/PlatformConfiguration/iOSSpecific/Page.cs index f0741afb4c4a..e8f2dbedab69 100644 --- a/src/Controls/src/Core/PlatformConfiguration/iOSSpecific/Page.cs +++ b/src/Controls/src/Core/PlatformConfiguration/iOSSpecific/Page.cs @@ -113,7 +113,7 @@ public static IPlatformElementConfiguration SetUseSafeArea(th } /// - /// Returns a Boolean value that tells whether the padding is overridden with the safe area. + /// Gets a value that represents whether the padding is overridden with the safe area. /// /// The element whose safe area behavior to get. /// true if the padding is overridden with the safe area; otherwise, false. From 55dda4636c7f51ef0f8135012f46137a952a2501 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Javier=20Su=C3=A1rez?= Date: Wed, 13 Mar 2024 13:46:19 +0100 Subject: [PATCH 13/22] More changes --- .../src/Core/PlatformConfiguration/iOSSpecific/Page.cs | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/src/Controls/src/Core/PlatformConfiguration/iOSSpecific/Page.cs b/src/Controls/src/Core/PlatformConfiguration/iOSSpecific/Page.cs index ea4fba40ac1c..bc4833b53fcf 100644 --- a/src/Controls/src/Core/PlatformConfiguration/iOSSpecific/Page.cs +++ b/src/Controls/src/Core/PlatformConfiguration/iOSSpecific/Page.cs @@ -72,7 +72,7 @@ public static IPlatformElementConfiguration SetPreferredStatu } /// - /// Controls whether padding values are overridden with the safe area insets. + /// This iOS platform-specific controls whether padding values are overridden with the safe area insets. /// #if MACCATALYST public static readonly BindableProperty UseSafeAreaProperty = BindableProperty.Create("UseSafeArea", typeof(bool), typeof(Page), true); @@ -94,7 +94,7 @@ public static bool GetUseSafeArea(BindableObject element) /// Sets a value that controls whether padding values are overridden with the safe area insets. /// /// The element whose safe area use behavior to set. - /// The new safe area inset behavior. + /// true to use the safe area inset behavior; otherwise, false. public static void SetUseSafeArea(BindableObject element, bool value) { element.SetValue(UseSafeAreaProperty, value); @@ -104,7 +104,7 @@ public static void SetUseSafeArea(BindableObject element, bool value) /// Sets a value that controls whether padding values are overridden with the safe area insets. /// /// The element whose safe area behavior to get. - /// The new safe area inset behavior. + /// true to use the safe area inset behavior; otherwise, false. /// public static IPlatformElementConfiguration SetUseSafeArea(this IPlatformElementConfiguration config, bool value) { @@ -236,7 +236,7 @@ static void SetModalPresentationStyle(BindableObject element, UIModalPresentatio /// Gets a value that indicates whether the visual indicator should hide upon returning to the home screen. /// /// A page, the VisualElement that occupies the entire screen. - /// + /// true if the home visual indicator is hidden; otherwise, false. public static bool GetPrefersHomeIndicatorAutoHidden(BindableObject element) { return (bool)element.GetValue(PrefersHomeIndicatorAutoHiddenProperty); From efe44dfb1693c517288f8aecf8b0442e886dff83 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Javier=20Su=C3=A1rez?= Date: Mon, 25 Mar 2024 16:56:38 +0100 Subject: [PATCH 14/22] Removed outdated xml comments --- .../Page.xml | 113 ------------------ 1 file changed, 113 deletions(-) diff --git a/src/Controls/docs/Microsoft.Maui.Controls.PlatformConfiguration.WindowsSpecific/Page.xml b/src/Controls/docs/Microsoft.Maui.Controls.PlatformConfiguration.WindowsSpecific/Page.xml index 688b903263e0..5435256775b3 100644 --- a/src/Controls/docs/Microsoft.Maui.Controls.PlatformConfiguration.WindowsSpecific/Page.xml +++ b/src/Controls/docs/Microsoft.Maui.Controls.PlatformConfiguration.WindowsSpecific/Page.xml @@ -17,52 +17,6 @@ To be added. - - - - - - Method - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.Boolean - - - - - - To be added. - To be added. - To be added. - To be added. - - - - - - - - Method - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.Boolean - - - - - - To be added. - To be added. - To be added. - To be added. - - @@ -111,55 +65,6 @@ To be added. - - - - - - Method - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.Void - - - - - - - To be added. - To be added. - To be added. - To be added. - - - - - - - - Method - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - Microsoft.Maui.Controls.IPlatformElementConfiguration<Microsoft.Maui.Controls.PlatformConfiguration.Windows,Microsoft.Maui.Controls.Page> - - - - - - - To be added. - To be added. - To be added. - To be added. - To be added. - - @@ -211,24 +116,6 @@ To be added. - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - Microsoft.Maui.Controls.BindableProperty - - - To be added. - To be added. - - From bd05bbc00d5316e7d5c4854a93dacdd24efe7e07 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Javier=20Su=C3=A1rez?= Date: Mon, 25 Mar 2024 17:11:35 +0100 Subject: [PATCH 15/22] More changes --- .../Page.xml | 324 ------------------ .../PlatformConfiguration/iOSSpecific/Page.cs | 4 +- 2 files changed, 2 insertions(+), 326 deletions(-) diff --git a/src/Controls/docs/Microsoft.Maui.Controls.PlatformConfiguration.iOSSpecific/Page.xml b/src/Controls/docs/Microsoft.Maui.Controls.PlatformConfiguration.iOSSpecific/Page.xml index eb4a21a68de2..9a23dc332a3f 100644 --- a/src/Controls/docs/Microsoft.Maui.Controls.PlatformConfiguration.iOSSpecific/Page.xml +++ b/src/Controls/docs/Microsoft.Maui.Controls.PlatformConfiguration.iOSSpecific/Page.xml @@ -41,29 +41,6 @@ To be added. - - - - - - Method - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - Microsoft.Maui.Controls.PlatformConfiguration.iOSSpecific.UIModalPresentationStyle - - - - - - The whose modal presentation style is being retrieved. - Gets the for . - To be added. - To be added. - - @@ -88,29 +65,6 @@ To be added. - - - - - - Method - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.Boolean - - - - - - To be added. - To be added. - To be added. - To be added. - - @@ -159,30 +113,6 @@ To be added. - - - - - - Method - - 0.0.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Boolean - - - - - - The element whose safe area behavior to get. - Gets a Boolean value that tells whether padding values are overridden with values that conform to the safe area on the device. - To be added. - To be added. - - @@ -226,49 +156,6 @@ To be added. - - - - - - Method - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - Microsoft.Maui.Controls.PlatformConfiguration.iOSSpecific.UIModalPresentationStyle - - - - - - - this - . - Gets the modal presentation style of this. - To be added. - To be added. - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - Microsoft.Maui.Controls.BindableProperty - - - The associated with the modal presentation style. - To be added. - - @@ -312,47 +199,6 @@ To be added. - - - - - - Method - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.Boolean - - - - - - To be added. - To be added. - To be added. - To be added. - - - - - - - - Field - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - Microsoft.Maui.Controls.BindableProperty - - - The backing store for the field. - To be added. - - @@ -490,33 +336,6 @@ To be added. - - - - - - Method - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - Microsoft.Maui.Controls.IPlatformElementConfiguration<Microsoft.Maui.Controls.PlatformConfiguration.iOS,Microsoft.Maui.Controls.Page> - - - - - - - - this - - The desired . - Sets the modal presentation style to . - To be added. - To be added. - - @@ -568,55 +387,6 @@ To be added. - - - - - - Method - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - System.Void - - - - - - - To be added. - To be added. - To be added. - To be added. - - - - - - - - Method - - Microsoft.Maui.Controls.Core - 2.0.0.0 - - - Microsoft.Maui.Controls.IPlatformElementConfiguration<Microsoft.Maui.Controls.PlatformConfiguration.iOS,Microsoft.Maui.Controls.Page> - - - - - - - To be added. - To be added. - To be added. - To be added. - To be added. - - @@ -699,99 +469,5 @@ To be added. - - - - - - Method - - 0.0.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Void - - - - - - - The element whose safe area use behavior to set. - The new safe area inset behavior. - Sets a value that controls whether padding values are overridden with the safe area insets. - To be added. - - - - - - - - Method - - 0.0.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - Microsoft.Maui.Controls.IPlatformElementConfiguration<Microsoft.Maui.Controls.PlatformConfiguration.iOS,Microsoft.Maui.Controls.Page> - - - - - - - The element whose safe area use behavior to set. - The new safe area inset behavior. - Sets a value that controls whether padding values are overridden with the safe area insets. - The updated configuration object on which developers can make successive method calls. - To be added. - - - - - - - - Field - - 0.0.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - Microsoft.Maui.Controls.BindableProperty - - - Backing store for the attached property that controls whether the padding is overridden with the safe area. - To be added. - - - - - - - - Method - - 0.0.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Boolean - - - - - - The element whose safe area behavior to get. - Returns a Boolean value that tells whether the padding is overridden with the safe area. - A Boolean value that tells whether the padding is overridden with the safe area. - To be added. - - diff --git a/src/Controls/src/Core/PlatformConfiguration/iOSSpecific/Page.cs b/src/Controls/src/Core/PlatformConfiguration/iOSSpecific/Page.cs index 9565f2d6162d..68d224a4a799 100644 --- a/src/Controls/src/Core/PlatformConfiguration/iOSSpecific/Page.cs +++ b/src/Controls/src/Core/PlatformConfiguration/iOSSpecific/Page.cs @@ -211,8 +211,8 @@ public static IPlatformElementConfiguration SetModalPresentat /// /// Gets the current value of the enumeration that's applied to the . /// - /// A page, the VisualElement that occupies the entire screen. - /// The current value of the UIModalPresentationStyle enumeration that's applied to the Page. + /// The whose modal presentation style is being retrieved. + /// The current value of the UIModalPresentationStyle enumeration that's applied to the . public static UIModalPresentationStyle GetModalPresentationStyle(BindableObject element) { return (UIModalPresentationStyle)element.GetValue(ModalPresentationStyleProperty); From d35795ef70feb9110b0584b5b87346475ca374fe Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Javier=20Su=C3=A1rez?= Date: Tue, 26 Mar 2024 14:39:40 +0100 Subject: [PATCH 16/22] Added pending langwords --- .../PlatformConfiguration/iOSSpecific/Page.cs | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/src/Controls/src/Core/PlatformConfiguration/iOSSpecific/Page.cs b/src/Controls/src/Core/PlatformConfiguration/iOSSpecific/Page.cs index 68d224a4a799..554b04a0d514 100644 --- a/src/Controls/src/Core/PlatformConfiguration/iOSSpecific/Page.cs +++ b/src/Controls/src/Core/PlatformConfiguration/iOSSpecific/Page.cs @@ -84,7 +84,7 @@ public static IPlatformElementConfiguration SetPreferredStatu /// Gets a value that indicates whether padding values are overridden with values that conform to the safe area on the device. /// /// The element to get the safe area behavior from. - /// true if the padding values are overridden; otherwise, false. + /// if the padding values are overridden; otherwise, . public static bool GetUseSafeArea(BindableObject element) { return (bool)element.GetValue(UseSafeAreaProperty); @@ -94,7 +94,7 @@ public static bool GetUseSafeArea(BindableObject element) /// Sets a value that controls whether padding values are overridden with the safe area insets. /// /// The element whose safe area use behavior to set. - /// true to use the safe area inset behavior; otherwise, false. + /// to use the safe area inset behavior; otherwise, . public static void SetUseSafeArea(BindableObject element, bool value) { element.SetValue(UseSafeAreaProperty, value); @@ -104,7 +104,7 @@ public static void SetUseSafeArea(BindableObject element, bool value) /// Sets a value that controls whether padding values are overridden with the safe area insets. /// /// The element whose safe area behavior to get. - /// true to use the safe area inset behavior; otherwise, false. + /// to use the safe area inset behavior; otherwise, . /// public static IPlatformElementConfiguration SetUseSafeArea(this IPlatformElementConfiguration config, bool value) { @@ -116,7 +116,7 @@ public static IPlatformElementConfiguration SetUseSafeArea(th /// Gets a value that represents whether the padding is overridden with the safe area. /// /// The element whose safe area behavior to get. - /// true if the padding is overridden with the safe area; otherwise, false. + /// if the padding is overridden with the safe area; otherwise, . public static bool UsingSafeArea(this IPlatformElementConfiguration config) { return GetUseSafeArea(config.Element); @@ -236,7 +236,7 @@ static void SetModalPresentationStyle(BindableObject element, UIModalPresentatio /// Gets a value that indicates whether the visual indicator should hide upon returning to the home screen. /// /// A page, the VisualElement that occupies the entire screen. - /// true if the home visual indicator is hidden; otherwise, false. + /// if the home visual indicator is hidden; otherwise, . public static bool GetPrefersHomeIndicatorAutoHidden(BindableObject element) { return (bool)element.GetValue(PrefersHomeIndicatorAutoHiddenProperty); @@ -246,7 +246,7 @@ public static bool GetPrefersHomeIndicatorAutoHidden(BindableObject element) /// Sets a value that indicates whether the visual indicator should hide upon returning to the home screen. /// /// A page, the VisualElement that occupies the entire screen. - /// true if hide the home indicator; otherwise, false. + /// if hide the home indicator; otherwise, . public static void SetPrefersHomeIndicatorAutoHidden(BindableObject element, bool value) { element.SetValue(PrefersHomeIndicatorAutoHiddenProperty, value); @@ -256,7 +256,7 @@ public static void SetPrefersHomeIndicatorAutoHidden(BindableObject element, boo /// Gets a Boolean that indicates whether is allowed to hide the visual indicator for returning to the Home Screen. /// /// The platform specific configuration that contains the element on which to perform the operation. - /// true if hide the home indicator; otherwise, false. + /// if hide the home indicator; otherwise, . public static bool PrefersHomeIndicatorAutoHidden(this IPlatformElementConfiguration config) { return GetPrefersHomeIndicatorAutoHidden(config.Element); @@ -266,7 +266,7 @@ public static bool PrefersHomeIndicatorAutoHidden(this IPlatformElementConfigura /// Sets a Boolean that indicates whether is allowed to hide the visual indicator for returning to the Home Screen. /// /// The platform specific configuration that contains the element on which to perform the operation. - /// true if hide the home indicator; otherwise, false. + /// if hide the home indicator; otherwise, . /// public static IPlatformElementConfiguration SetPrefersHomeIndicatorAutoHidden(this IPlatformElementConfiguration config, bool value) { From 52dbd0e601b1e39abae2101ca2d1c5e92809c18d Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Javier=20Su=C3=A1rez?= Date: Tue, 26 Mar 2024 15:50:08 +0100 Subject: [PATCH 17/22] More fixes --- .../src/Core/PlatformConfiguration/iOSSpecific/Page.cs | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/src/Controls/src/Core/PlatformConfiguration/iOSSpecific/Page.cs b/src/Controls/src/Core/PlatformConfiguration/iOSSpecific/Page.cs index 554b04a0d514..03c2067b78d1 100644 --- a/src/Controls/src/Core/PlatformConfiguration/iOSSpecific/Page.cs +++ b/src/Controls/src/Core/PlatformConfiguration/iOSSpecific/Page.cs @@ -105,7 +105,7 @@ public static void SetUseSafeArea(BindableObject element, bool value) /// /// The element whose safe area behavior to get. /// to use the safe area inset behavior; otherwise, . - /// + /// The updated configuration object on which developers can make successive method calls. public static IPlatformElementConfiguration SetUseSafeArea(this IPlatformElementConfiguration config, bool value) { SetUseSafeArea(config.Element, value); @@ -212,14 +212,14 @@ public static IPlatformElementConfiguration SetModalPresentat /// Gets the current value of the enumeration that's applied to the . /// /// The whose modal presentation style is being retrieved. - /// The current value of the UIModalPresentationStyle enumeration that's applied to the . + /// The current value of the enumeration that's applied to the . public static UIModalPresentationStyle GetModalPresentationStyle(BindableObject element) { return (UIModalPresentationStyle)element.GetValue(ModalPresentationStyleProperty); } /// - /// Sets the modal presentation style on a Page. + /// Sets the modal presentation style on a . /// /// A page, the VisualElement that occupies the entire screen. /// The modal presentation style. @@ -267,7 +267,7 @@ public static bool PrefersHomeIndicatorAutoHidden(this IPlatformElementConfigura /// /// The platform specific configuration that contains the element on which to perform the operation. /// if hide the home indicator; otherwise, . - /// + /// The updated configuration object on which developers can make successive method calls. public static IPlatformElementConfiguration SetPrefersHomeIndicatorAutoHidden(this IPlatformElementConfiguration config, bool value) { SetPrefersHomeIndicatorAutoHidden(config.Element, value); From 0d13ee21b86cf80403e7171c7778bc6c92ff56e6 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Javier=20Su=C3=A1rez?= Date: Tue, 26 Mar 2024 15:52:51 +0100 Subject: [PATCH 18/22] More changes --- .../src/Core/PlatformConfiguration/WindowsSpecific/Page.cs | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/Controls/src/Core/PlatformConfiguration/WindowsSpecific/Page.cs b/src/Controls/src/Core/PlatformConfiguration/WindowsSpecific/Page.cs index 3b47b0691405..c8d8f0c1658d 100644 --- a/src/Controls/src/Core/PlatformConfiguration/WindowsSpecific/Page.cs +++ b/src/Controls/src/Core/PlatformConfiguration/WindowsSpecific/Page.cs @@ -91,7 +91,7 @@ public static bool GetToolbarDynamicOverflowEnabled(this IPlatformElementConfigu /// /// The platform specific configuration that contains the element on which to perform the operation. /// A value that indicates whether toolbar items automatically move to the overflow menu when space is limited - /// if toolbar items automatically move to the overflow menu when space is limited; otherwise, . + /// The updated configuration object on which developers can make successive method calls. public static IPlatformElementConfiguration SetToolbarDynamicOverflowEnabled( this IPlatformElementConfiguration config, bool value) { From 7a031228fbc68968f020265a2e6ee6284f4accbf Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Javier=20Su=C3=A1rez?= Date: Thu, 11 Apr 2024 12:31:00 +0200 Subject: [PATCH 19/22] Removed Windows platform specific Page xml file --- .../Page.xml | 139 ------------------ .../WindowsSpecific/Page.cs | 33 ++++- 2 files changed, 27 insertions(+), 145 deletions(-) delete mode 100644 src/Controls/docs/Microsoft.Maui.Controls.PlatformConfiguration.WindowsSpecific/Page.xml diff --git a/src/Controls/docs/Microsoft.Maui.Controls.PlatformConfiguration.WindowsSpecific/Page.xml b/src/Controls/docs/Microsoft.Maui.Controls.PlatformConfiguration.WindowsSpecific/Page.xml deleted file mode 100644 index 5435256775b3..000000000000 --- a/src/Controls/docs/Microsoft.Maui.Controls.PlatformConfiguration.WindowsSpecific/Page.xml +++ /dev/null @@ -1,139 +0,0 @@ - - - - - - - Microsoft.Maui.Controls.Core - 0.0.0.0 - 2.0.0.0 - - - System.Object - - - - The page instance that Microsoft.Maui.Controls created on the Windows platform. - To be added. - - - - - - - - Method - - 0.0.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - Microsoft.Maui.Controls.PlatformConfiguration.WindowsSpecific.ToolbarPlacement - - - - - - The platform specific element on which to perform the operation. - Returns a value that controls the placement of the toolbar. - A value that controls the placement of the toolbar. - To be added. - - - - - - - - Method - - 0.0.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - Microsoft.Maui.Controls.PlatformConfiguration.WindowsSpecific.ToolbarPlacement - - - - - - The platform specific configuration that contains the element on which to perform the operation. - Returns a value that controls the placement of the toolbar. - A value that controls the placement of the toolbar. - To be added. - - - - - - - - Method - - 0.0.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Void - - - - - - - The platform specific element on which to perform the operation. - The new toolbar placement. - Sets a value that controls the placement of the toolbar. - To be added. - - - - - - - - Method - - 0.0.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - Microsoft.Maui.Controls.IPlatformElementConfiguration<Microsoft.Maui.Controls.PlatformConfiguration.Windows,Microsoft.Maui.Controls.Page> - - - - - - - The platform specific configuration that contains the element on which to perform the operation. - The new property value to assign. - Sets a value that controls the placement of the toolbar. - The updated configuration object on which developers can make successive method calls. - To be added. - - - - - - - - Field - - 0.0.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - Microsoft.Maui.Controls.BindableProperty - - - Backing store for the attached property that controls the placement of the toolbar. - To be added. - - - - diff --git a/src/Controls/src/Core/PlatformConfiguration/WindowsSpecific/Page.cs b/src/Controls/src/Core/PlatformConfiguration/WindowsSpecific/Page.cs index c8d8f0c1658d..b7e45e5549cc 100644 --- a/src/Controls/src/Core/PlatformConfiguration/WindowsSpecific/Page.cs +++ b/src/Controls/src/Core/PlatformConfiguration/WindowsSpecific/Page.cs @@ -9,35 +9,56 @@ namespace Microsoft.Maui.Controls.PlatformConfiguration.WindowsSpecific { using FormsElement = Maui.Controls.Page; - /// + /// + /// The page instance that Microsoft.Maui.Controls created on the Windows platform. + /// public static class Page { #region ToolbarPlacement - /// Bindable property for . + /// + /// Backing store for the attached property that controls the placement of the toolbar. + /// public static readonly BindableProperty ToolbarPlacementProperty = BindableProperty.CreateAttached("ToolbarPlacement", typeof(ToolbarPlacement), typeof(FormsElement), ToolbarPlacement.Default); - /// + /// + /// Returns a value that controls the placement of the toolbar. + /// + /// The platform specific element on which to perform the operation. + /// A value that controls the placement of the toolbar. public static ToolbarPlacement GetToolbarPlacement(BindableObject element) { return (ToolbarPlacement)element.GetValue(ToolbarPlacementProperty); } - /// + /// + /// Sets a value that controls the placement of the toolbar. + /// + /// The platform specific element on which to perform the operation. + /// The new toolbar placement. public static void SetToolbarPlacement(BindableObject element, ToolbarPlacement toolbarPlacement) { element.SetValue(ToolbarPlacementProperty, toolbarPlacement); } - /// + /// + /// Returns a value that controls the placement of the toolbar. + /// + /// The platform specific configuration that contains the element on which to perform the operation. + /// A value that controls the placement of the toolbar. public static ToolbarPlacement GetToolbarPlacement(this IPlatformElementConfiguration config) { return (ToolbarPlacement)config.Element.GetValue(ToolbarPlacementProperty); } - /// + /// + /// Sets a value that controls the placement of the toolbar. + /// + /// The platform specific configuration that contains the element on which to perform the operation. + /// The new property value to assign. + /// The updated configuration object on which developers can make successive method calls. public static IPlatformElementConfiguration SetToolbarPlacement( this IPlatformElementConfiguration config, ToolbarPlacement value) { From 21596761e048da43a1a3f11b2bbfc842bf69568f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Javier=20Su=C3=A1rez?= Date: Thu, 11 Apr 2024 12:59:02 +0200 Subject: [PATCH 20/22] Removed iOS platform specific page xml docs --- .../Page.xml | 473 ------------------ .../PlatformConfiguration/iOSSpecific/Page.cs | 112 ++++- 2 files changed, 92 insertions(+), 493 deletions(-) delete mode 100644 src/Controls/docs/Microsoft.Maui.Controls.PlatformConfiguration.iOSSpecific/Page.xml diff --git a/src/Controls/docs/Microsoft.Maui.Controls.PlatformConfiguration.iOSSpecific/Page.xml b/src/Controls/docs/Microsoft.Maui.Controls.PlatformConfiguration.iOSSpecific/Page.xml deleted file mode 100644 index 9a23dc332a3f..000000000000 --- a/src/Controls/docs/Microsoft.Maui.Controls.PlatformConfiguration.iOSSpecific/Page.xml +++ /dev/null @@ -1,473 +0,0 @@ - - - - - - - Microsoft.Maui.Controls.Core - 0.0.0.0 - 2.0.0.0 - - - System.Object - - - - The page instance that Microsoft.Maui.Controls created on the iOS platform. - To be added. - - - - - - - - Method - - 0.0.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - Microsoft.Maui.Controls.PlatformConfiguration.iOSSpecific.LargeTitleDisplayMode - - - - - - The element whose large title display preferences to get. - Returns the large title display preferences for . - The large title display preferences for . - To be added. - - - - - - - - Method - - 0.0.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - Microsoft.Maui.Controls.PlatformConfiguration.iOSSpecific.UIStatusBarAnimation - - - - - - The platform specific element on which to perform the operation. - Returns a value that tells whether the preferred animation style to use when updating the status bar is None, Slide, or Fade. - A value that tells whether the preferred animation style to use when updating the status bar is None, Slide, or Fade. - To be added. - - - - - - - - Method - - 0.0.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - Microsoft.Maui.Controls.PlatformConfiguration.iOSSpecific.StatusBarHiddenMode - - - - - - The platform specific element on which to perform the operation. - Returns a value that tells whether it is preferred that the status bar is shown, hidden, or relies on the system default. - A value that tells whether it is preferred that the status bar is shown, hidden, or relies on the system default. - To be added. - - - - - - - - Method - - 0.0.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - Microsoft.Maui.Thickness - - - - - - The element whose safe area insets to get. - Returns the safe area insets for . - The safe area insets for . - To be added. - - - - - - - - Method - - 0.0.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - Microsoft.Maui.Controls.PlatformConfiguration.iOSSpecific.LargeTitleDisplayMode - - - - - - The element whose large title preferences to return. - Returns a value that describes the large title behavior preference of . - A value that describes the large title behavior preference of . - To be added. - - - - - - - - Field - - 0.0.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - Microsoft.Maui.Controls.BindableProperty - - - Backing store for the attached property that defines the large title preferences of the page. - To be added. - - - - - - - - Method - - 0.0.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - Microsoft.Maui.Controls.PlatformConfiguration.iOSSpecific.UIStatusBarAnimation - - - - - - The platform specific configuration that contains the element on which to perform the operation. - Returns a value that tells whether the preferred animation style to use when updating the status bar is None, Slide, or Fade. - A value that tells whether the preferred animation style to use when updating the status bar is None, Slide, or Fade. - To be added. - - - - - - - - Field - - 0.0.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - Microsoft.Maui.Controls.BindableProperty - - - Backing store for the attached property that controls whether the preferred animation style to use when updating the status bar is None, Slide, or Fade. - To be added. - - - - - - - - Method - - 0.0.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - Microsoft.Maui.Controls.PlatformConfiguration.iOSSpecific.StatusBarHiddenMode - - - - - - The platform specific configuration that contains the element on which to perform the operation. - Sets a value that controls whether it is preferred that the status bar is shown, hidden, or relies on the system default. - A value that controls whether it is preferred that the status bar is shown, hidden, or relies on the system default. - To be added. - - - - - - - - Field - - 0.0.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - Microsoft.Maui.Controls.BindableProperty - - - Sets a value that controls whether it is preferred that the status bar is shown, hidden, or relies on the system default. - To be added. - - - - - - - - Method - - 0.0.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - Microsoft.Maui.Thickness - - - - - - The element whose safe area insets to return. - Returns a object that represents the safe area insets. - A object that represents the safe area insets. - To be added. - - - - - - - - Field - - 0.0.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - Microsoft.Maui.Controls.BindableProperty - - - Backing store for the attached property that represents the safe area insets. - To be added. - - - - - - - - Method - - 0.0.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Void - - - - - - - The element whose large title display preference to set. - The new large title display preferences. - Sets the large title display preferences of to . - To be added. - - - - - - - - Method - - 0.0.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - Microsoft.Maui.Controls.IPlatformElementConfiguration<Microsoft.Maui.Controls.PlatformConfiguration.iOS,Microsoft.Maui.Controls.Page> - - - - - - - The element whose large title display preference to set. - The new large title display preferences. - Sets the large title display preferences of to . - The updated configuration object on which developers can make successive method calls. - To be added. - - - - - - - - Method - - 0.0.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Void - - - - - - - The platform specific element on which to perform the operation. - The new property value to assign. - Sets a value that controls whether the preferred animation style to use when updating the status bar is None, Slide, or Fade. - To be added. - - - - - - - - Method - - 0.0.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - Microsoft.Maui.Controls.IPlatformElementConfiguration<Microsoft.Maui.Controls.PlatformConfiguration.iOS,Microsoft.Maui.Controls.Page> - - - - - - - The platform specific configuration that contains the element on which to perform the operation. - The new property value to assign. - Sets a value that controls whether the preferred animation style to use when updating the status bar is None, Slide, or Fade. - The updated configuration object on which developers can make successive method calls. - To be added. - - - - - - - - Method - - 0.0.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - System.Void - - - - - - - The platform specific element on which to perform the operation. - The new property value to assign. - Sets a value that controls whether it is preferred that the status bar is shown, hidden, or relies on the system default. - To be added. - - - - - - - - Method - - 0.0.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - Microsoft.Maui.Controls.IPlatformElementConfiguration<Microsoft.Maui.Controls.PlatformConfiguration.iOS,Microsoft.Maui.Controls.Page> - - - - - - - The platform specific configuration that contains the element on which to perform the operation. - The new property value to assign. - Sets a value that controls whether it is preferred that the status bar is shown, hidden, or relies on the system default. - The updated configuration object on which developers can make successive method calls. - To be added. - - - - - - - - Method - - 0.0.0.0 - 2.0.0.0 - Microsoft.Maui.Controls.Core - - - - System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never) - - - - Microsoft.Maui.Controls.IPlatformElementConfiguration<Microsoft.Maui.Controls.PlatformConfiguration.iOS,Microsoft.Maui.Controls.Page> - - - - - - - The element whose safe area insets to set. - The new safe area insets. - Sets the safe area insets of to - The updated configuration object on which developers can make successive method calls. - To be added. - - - - diff --git a/src/Controls/src/Core/PlatformConfiguration/iOSSpecific/Page.cs b/src/Controls/src/Core/PlatformConfiguration/iOSSpecific/Page.cs index 03c2067b78d1..42ac918124a7 100644 --- a/src/Controls/src/Core/PlatformConfiguration/iOSSpecific/Page.cs +++ b/src/Controls/src/Core/PlatformConfiguration/iOSSpecific/Page.cs @@ -5,49 +5,80 @@ namespace Microsoft.Maui.Controls.PlatformConfiguration.iOSSpecific { using FormsElement = Maui.Controls.Page; - /// + /// + /// The page instance that Microsoft.Maui.Controls created on the iOS platform. + /// public static class Page { - /// Bindable property for . + /// + /// Sets a value that controls whether it is preferred that the status bar is shown, hidden, or relies on the system default. + /// public static readonly BindableProperty PrefersStatusBarHiddenProperty = BindableProperty.Create("PrefersStatusBarHidden", typeof(StatusBarHiddenMode), typeof(Page), StatusBarHiddenMode.Default); - /// + /// + /// Returns a value that tells whether it is preferred that the status bar is shown, hidden, or relies on the system default. + /// + /// The platform specific element on which to perform the operation. + /// A value that tells whether it is preferred that the status bar is shown, hidden, or relies on the system default. public static StatusBarHiddenMode GetPrefersStatusBarHidden(BindableObject element) { return (StatusBarHiddenMode)element.GetValue(PrefersStatusBarHiddenProperty); } - /// + /// + /// Sets a value that controls whether it is preferred that the status bar is shown, hidden, or relies on the system default. + /// + /// The platform specific element on which to perform the operation. + /// The new property value to assign. public static void SetPrefersStatusBarHidden(BindableObject element, StatusBarHiddenMode value) { element.SetValue(PrefersStatusBarHiddenProperty, value); } - /// + /// + /// Sets a value that controls whether it is preferred that the status bar is shown, hidden, or relies on the system default. + /// + /// The platform specific configuration that contains the element on which to perform the operation. + /// A value that controls whether it is preferred that the status bar is shown, hidden, or relies on the system default. public static StatusBarHiddenMode PrefersStatusBarHidden(this IPlatformElementConfiguration config) { return GetPrefersStatusBarHidden(config.Element); } - /// + /// + /// Sets a value that controls whether it is preferred that the status bar is shown, hidden, or relies on the system default. + /// + /// The platform specific configuration that contains the element on which to perform the operation. + /// The new property value to assign. + /// The updated configuration object on which developers can make successive method calls. public static IPlatformElementConfiguration SetPrefersStatusBarHidden(this IPlatformElementConfiguration config, StatusBarHiddenMode value) { SetPrefersStatusBarHidden(config.Element, value); return config; } - /// Bindable property for . + /// + /// Backing store for the attached property that controls whether the preferred animation style to use when updating the status bar is None, Slide, or Fade. + /// public static readonly BindableProperty PreferredStatusBarUpdateAnimationProperty = BindableProperty.Create("PreferredStatusBarUpdateAnimation", typeof(UIStatusBarAnimation), typeof(Page), UIStatusBarAnimation.None); - /// + /// + /// Returns a value that tells whether the preferred animation style to use when updating the status bar is None, Slide, or Fade. + /// + /// The platform specific element on which to perform the operation. + /// A value that tells whether the preferred animation style to use when updating the status bar is None, Slide, or Fade. public static UIStatusBarAnimation GetPreferredStatusBarUpdateAnimation(BindableObject element) { return (UIStatusBarAnimation)element.GetValue(PreferredStatusBarUpdateAnimationProperty); } - /// + /// + /// Sets a value that controls whether the preferred animation style to use when updating the status bar is None, Slide, or Fade. + /// + /// The platform specific element on which to perform the operation. + /// The new property value to assign. public static void SetPreferredStatusBarUpdateAnimation(BindableObject element, UIStatusBarAnimation value) { if (value == UIStatusBarAnimation.Fade) @@ -58,13 +89,22 @@ public static void SetPreferredStatusBarUpdateAnimation(BindableObject element, element.SetValue(PreferredStatusBarUpdateAnimationProperty, value); } - /// + /// + /// Returns a value that tells whether the preferred animation style to use when updating the status bar is None, Slide, or Fade. + /// + /// The platform specific configuration that contains the element on which to perform the operation. + /// A value that tells whether the preferred animation style to use when updating the status bar is None, Slide, or Fade. public static UIStatusBarAnimation PreferredStatusBarUpdateAnimation(this IPlatformElementConfiguration config) { return GetPreferredStatusBarUpdateAnimation(config.Element); } - /// + /// + /// Sets a value that controls whether the preferred animation style to use when updating the status bar is None, Slide, or Fade. + /// + /// The platform specific configuration that contains the element on which to perform the operation. + /// The new property value to assign. + /// The updated configuration object on which developers can make successive method calls. public static IPlatformElementConfiguration SetPreferredStatusBarUpdateAnimation(this IPlatformElementConfiguration config, UIStatusBarAnimation value) { SetPreferredStatusBarUpdateAnimation(config.Element, value); @@ -125,25 +165,42 @@ public static bool UsingSafeArea(this IPlatformElementConfigurationBindable property for . public static readonly BindableProperty LargeTitleDisplayProperty = BindableProperty.Create(nameof(LargeTitleDisplay), typeof(LargeTitleDisplayMode), typeof(Page), LargeTitleDisplayMode.Automatic); - /// + /// + /// Returns the large title display preferences for . + /// + /// The element whose large title display preferences to get. + /// The large title display preferences for . public static LargeTitleDisplayMode GetLargeTitleDisplay(BindableObject element) { return (LargeTitleDisplayMode)element.GetValue(LargeTitleDisplayProperty); } - /// + /// + /// Sets the large title display preferences of to . + /// + /// The element whose large title display preference to set. + /// The new large title display preferences. public static void SetLargeTitleDisplay(BindableObject element, LargeTitleDisplayMode value) { element.SetValue(LargeTitleDisplayProperty, value); } - /// + /// + /// Returns a value that describes the large title behavior preference of . + /// + /// The element whose large title preferences to return. + /// A value that describes the large title behavior preference of . public static LargeTitleDisplayMode LargeTitleDisplay(this IPlatformElementConfiguration config) { return GetLargeTitleDisplay(config.Element); } - /// + /// + /// Sets the large title display preferences of to . + /// + /// The element whose large title display preference to set. + /// The new large title display preferences. + /// The updated configuration object on which developers can make successive method calls. public static IPlatformElementConfiguration SetLargeTitleDisplay(this IPlatformElementConfiguration config, LargeTitleDisplayMode value) { SetLargeTitleDisplay(config.Element, value); @@ -152,10 +209,16 @@ public static IPlatformElementConfiguration SetLargeTitleDisp static readonly BindablePropertyKey SafeAreaInsetsPropertyKey = BindableProperty.CreateReadOnly(nameof(SafeAreaInsets), typeof(Thickness), typeof(Page), default(Thickness)); - /// Bindable property for . + /// + /// Backing store for the attached property that represents the safe area insets. + /// public static readonly BindableProperty SafeAreaInsetsProperty = SafeAreaInsetsPropertyKey.BindableProperty; - /// + /// + /// Returns the safe area insets for . + /// + /// The element whose safe area insets to get. + /// The safe area insets for . public static Thickness GetSafeAreaInsets(BindableObject element) { return (Thickness)element.GetValue(SafeAreaInsetsProperty); @@ -166,13 +229,22 @@ static void SetSafeAreaInsets(BindableObject element, Thickness value) element.SetValue(SafeAreaInsetsPropertyKey, value); } - /// + /// + /// Returns a object that represents the safe area insets. + /// + /// The element whose safe area insets to return. + /// A object that represents the safe area insets. public static Thickness SafeAreaInsets(this IPlatformElementConfiguration config) { return GetSafeAreaInsets(config.Element); } - /// + /// + /// Sets the safe area insets of to . + /// + /// The element whose safe area insets to set. + /// The new safe area insets. + /// The updated configuration object on which developers can make successive method calls. [EditorBrowsable(EditorBrowsableState.Never)] public static IPlatformElementConfiguration SetSafeAreaInsets(this IPlatformElementConfiguration config, Thickness value) { @@ -274,4 +346,4 @@ public static IPlatformElementConfiguration SetPrefersHomeInd return config; } } -} +} \ No newline at end of file From 2082bd28d87cf4e8ad0157e0af9cfee3228b3fd3 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Javier=20Su=C3=A1rez?= Date: Thu, 25 Apr 2024 16:38:34 +0200 Subject: [PATCH 21/22] More fixes --- src/TestUtils/src/UITest.Appium/HelperExtensions.cs | 5 ----- 1 file changed, 5 deletions(-) diff --git a/src/TestUtils/src/UITest.Appium/HelperExtensions.cs b/src/TestUtils/src/UITest.Appium/HelperExtensions.cs index 4acac365e99b..e99caac17f61 100644 --- a/src/TestUtils/src/UITest.Appium/HelperExtensions.cs +++ b/src/TestUtils/src/UITest.Appium/HelperExtensions.cs @@ -34,11 +34,6 @@ public static void Click(this IApp app, string element) app.FindElement(element).Click(); } - public static void Tap(this IApp app, string element) - { - app.FindElement(element).Click(); - } - public static string? GetText(this IUIElement element) { var response = element.Command.Execute("getText", new Dictionary() From 4c0a12461e26dded1f1ed3c33a0f11f7e2b95d57 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Javier=20Su=C3=A1rez?= Date: Mon, 3 Jun 2024 13:29:01 +0200 Subject: [PATCH 22/22] Updated docs --- .../src/Core/PlatformConfiguration/WindowsSpecific/Page.cs | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/Controls/src/Core/PlatformConfiguration/WindowsSpecific/Page.cs b/src/Controls/src/Core/PlatformConfiguration/WindowsSpecific/Page.cs index b7e45e5549cc..dd29459aadb4 100644 --- a/src/Controls/src/Core/PlatformConfiguration/WindowsSpecific/Page.cs +++ b/src/Controls/src/Core/PlatformConfiguration/WindowsSpecific/Page.cs @@ -10,7 +10,7 @@ namespace Microsoft.Maui.Controls.PlatformConfiguration.WindowsSpecific using FormsElement = Maui.Controls.Page; /// - /// The page instance that Microsoft.Maui.Controls created on the Windows platform. + /// Provides the Page Windows Platform-Specific Functionality. /// public static class Page {