diff --git a/docs/migration/includes/api-changes.md b/docs/migration/includes/api-changes.md index 7a71b4d8d9..e9217e1fb1 100644 --- a/docs/migration/includes/api-changes.md +++ b/docs/migration/includes/api-changes.md @@ -37,6 +37,8 @@ In addition, all of the numeric values in a [!div class="mx-tdBreakAll"] > | Xamarin.Forms API | .NET MAUI API | Comments | > | ----------------- | ------------- | -------- | @@ -46,6 +48,20 @@ The following table lists the layout APIs that have been removed in the move fro > | | | No .NET MAUI equivalent. | > | | | In .NET MAUI, `RelativeLayout` only exists as a compatibility control for users migrating from Xamarin.Forms. Use instead, or add the `xmlns` for the compatibility namespace. | +::: moniker-end + +::: moniker range=">=net-maui-8.0" + +> [!div class="mx-tdBreakAll"] +> | Xamarin.Forms API | .NET MAUI API | Comments | +> | ----------------- | ------------- | -------- | +> | | | The `Add` overload that accepts 3 arguments isn't present in .NET MAUI. | +> | | | No .NET MAUI equivalent. | +> | | | No .NET MAUI equivalent. | +> | | | In .NET MAUI, `RelativeLayout` only exists as a compatibility control for users migrating from Xamarin.Forms. Use instead, or add the `xmlns` for the compatibility namespace. | + +::: moniker-end + In addition, adding children to a layout in code in Xamarin.Forms is accomplished by adding the children to the layout's `Children` collection: ```csharp diff --git a/docs/user-interface/layouts/grid.md b/docs/user-interface/layouts/grid.md index 0eef803dd9..7218a5ac7b 100644 --- a/docs/user-interface/layouts/grid.md +++ b/docs/user-interface/layouts/grid.md @@ -256,6 +256,13 @@ public class BasicGridPage : ContentPage In code, to specify the height of a `RowDefinition` object, and the width of a `ColumnDefinition` object, you use values of the `GridLength` structure, often in combination with the `GridUnitType` enumeration. +::: moniker range=">=net-maui-8.0" + +> [!NOTE] +> also defines an `AddWithSpan` extension method that adds a view to the `Grid` at the specified row and column with the specified row and column spans. + +::: moniker-end + ### Simplify row and column definitions In XAML, the row and column characteristics of a can be specified using a simplified syntax that avoids having to define `RowDefinition` and `ColumnDefinition` objects for each row and column. Instead, the `RowDefinitions` and `ColumnDefinitions` properties can be set to strings containing comma-delimited `GridUnitType` values, from which type converters built into .NET MAUI create `RowDefinition` and `ColumnDefinition` objects: diff --git a/docs/whats-new/dotnet-8.md b/docs/whats-new/dotnet-8.md index 5be9bf5263..da35b0cbcb 100644 --- a/docs/whats-new/dotnet-8.md +++ b/docs/whats-new/dotnet-8.md @@ -24,7 +24,9 @@ For information about what's new in .NET 8, see [What's new in .NET 8](/dotnet/c - The position at which a drag or drop gesture occurred can be obtained by calling the `GetPosition` method on a , , or object. For more information, see [Recognize a drag and drop gesture](~/fundamentals/gestures/drag-and-drop.md). - gains a `UserAgent` property. For more information, see [WebView](~/user-interface/controls/webview.md). - Inline media playback of HTML5 video, including autoplay and picture in picture, has been enabled by default for the on iOS. For more information, see [Set media playback preferences on iOS and Mac Catalyst](~/user-interface/controls/webview.md#set-media-playback-preferences-on-ios-and-mac-catalyst). -- Reources defined in a can also be consumed in an [`AppThemeBinding`](xref:Microsoft.Maui.Controls.Xaml.AppThemeBindingExtension) with the [`DynamicResource`](xref:Microsoft.Maui.Controls.Xaml.DynamicResourceExtension) markup extension. For more information, see [Define and consume theme resources](~/user-interface/system-theme-changes.md#define-and-consume-theme-resources). +- Resources defined in a can also be consumed in an [`AppThemeBinding`](xref:Microsoft.Maui.Controls.Xaml.AppThemeBindingExtension) with the [`DynamicResource`](xref:Microsoft.Maui.Controls.Xaml.DynamicResourceExtension) markup extension. For more information, see [Define and consume theme resources](~/user-interface/system-theme-changes.md#define-and-consume-theme-resources). +- The `Grid.Add` overload that accepts 5 arguments has been added back to .NET MAUI. However, this method is deprecated and is only present to aid migrations from Xamarin.Forms. +- gains an `AddWithSpan` extension method that adds a view to the `Grid` at the specified row and column with the specified row and column spans. The following types or members have been deprecated: