Width and Height getters on Window returns NaN on Mac

[codecat]

Describe the bug

On Mac, the getters for Width and Height are returning NaN instead of the actual window size, when the size is not already set. It seems the difference between Windows and Mac is that on Mac, there is no entry in ValueStore._effectiveValues for it.

To Reproduce

Create a window where the xaml doesn't contain Width=".." Height="..". For example:

<Window xmlns="https://github.com/avaloniaui"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
        xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
        mc:Ignorable="d"
        x:Class="TestApp.MainWindow"
        Title="Test App">
	<TextBlock>Hello world</TextBlock>
</Window>

Print the Width and Height anywhere:

protected override void OnOpened(EventArgs e)
{
	base.OnOpened(e);

	Console.WriteLine($"Width = {Width} Height = {Height}");
}

Expected behavior

On Windows, Width and Height are the actual window size. On Mac, the returned values are both NaN.

Avalonia version

master

OS

macOS

Additional context

This popped up when writing an integration test for #18004. I have not tested the behavior on Linux.

[Gillibald]

You should always listen to Bounds -> RenderSize and not listen to (Width and Height) -> requested size

[maxkatz6]

@Gillibald I am not sure if that's the case with Window Height/Width.

[Gillibald]

The FrameSize/ClientSize should always be set in the end

[codecat]

This feels like a misleading API then. Perhaps the properties should be made private, or renamed (to something like RequestedWidth), but I understand also that this probably has to stay for xaml compatibility. (Unless there's an attribute that can change xaml property name separately from code property name?)

If this is "by design", it's not a very good design, imho.

[stevemonaco]

The XML docs here could use some improvement.

Avalonia/src/Avalonia.Base/Layout/Layoutable.cs

Lines 222 to 238 in 98a388d

	/// <summary>
	/// Gets or sets the width of the element.
	/// </summary>
	public double Width
	{
	get { return GetValue(WidthProperty); }
	set { SetValue(WidthProperty, value); }
	}
	/// <summary>
	/// Gets or sets the height of the element.
	/// </summary>
	public double Height
	{
	get { return GetValue(HeightProperty); }
	set { SetValue(HeightProperty, value); }
	}

WPF says it more accurately: Gets or sets the suggested height of the element.

Keep in mind that all layout properties on a control are suggestions: parent layout controls are free to completely ignore them if they wish although good ones comply as much as possible. Height, MinHeight, MaxHeight, alignments, padding, margin, etc.

This design is almost 20 years old from WPF, so it's both well-known and backwards-compatible. UWP follows the same. On Maui, there's Height (readonly) and HeightRequest which makes things a bit clearer for beginners.

[timunie]

I agree on the xml comments. It should also explain what NaN means for the system.