WindowControl

WindowControl is a control that looks and acts like a Window, but can be used anywhere a Control can be used. This is especially useful when developing single-page applications that need Window-like capabilities.

A WindowControl displayed in light and dark theme variants }

WindowControl is a Control that implements most of the same members as the standard Avalonia Window class.

What Can I Do with WindowControl?

Unlike a normal Window, WindowControl can be put in any control hierarchy. It also supports complete templating and can be animated.

Restrictions

Since WindowControl is a Control it still must be contained by a root TopLevel.

Working with the WindowControl

As mentioned above we implemented many of the same members found in a Avalonia Window within WindowControl. You can set properties such as WindowState or CanResize. Browse through the members list on the WindowControl control to see what is available to you.

There are also a number of extra properties, methods, and events that aren't on Window, such as the ToggleWindowState method, the TitleBarMenuOpening event, etc.

Title bar drags and border resize operations will cause the control's Left, Top, Width, and Height properties to be altered. To support drag operations visually, place the WindowControl in a Canvas and bind the Canvas.Left attached property to the WindowControl.Left property, and Canvas.Top attached property to the WindowControl.Top property.

xmlns:actipro="http://schemas.actiprosoftware.com/avaloniaui"
...
<Canvas>
	<actipro:WindowControl ...
		Canvas.Left="{Binding $self.Left, Mode=OneWay}"
		Canvas.Top="{Binding $self.Top, Mode=OneWay}">

		...

	</actipro:WindowControl>
</Canvas>

Managing the Title Bar

The title bar can be hidden entirely by setting HasTitleBar to false. Alternatively, the buttons, icon, and text displayed by the title bar can be customized as described below.

Buttons

A number of properties can be used to alter the state or visibility of the title bar buttons. By default, the current window state governs which of the minimize, restore, and maximize buttons are visible.

The CanClose property indicates if the Close button is enabled.

Sometimes it is useful to be able to always force one or more of the buttons to be hidden. One use case is where you don't wish to allow minimization of the window and never want the Minimize button visible. The IsMinimizeButtonAllowed, IsRestoreButtonAllowed, IsMaximizeButtonAllowed, and IsCloseButtonAllowed properties can be set to false to specify that their related button should never be visible.

Icon

An icon can be displayed by setting WindowControl.Icon to an object that defines an icon. By default, the icon is displayed when an non-null icon is specified. You can alter this behavior by explicitly setting WindowControl.IsIconVisible. Therefore, you can force the WindowControl to hide an icon by setting IsIconVisible to false.

Any content supported by Icon Presenter can be used to define the icons (like IImage data, PathIcon control, or DynamicImage control).

Custom Title Bar Content

Additional content can be added to the title bar by setting a custom WindowControl.TitleBarTheme. The following demonstrates how to add an Avatar control to the right content of the title bar:

xmlns:actipro="http://schemas.actiprosoftware.com/avaloniaui"
...
<actipro:WindowControl ... >

	<actipro:WindowControl.TitleBarTheme>
		<ControlTheme TargetType="actiproPrimitives:ChromedTitleBar" BasedOn="{actipro:ControlTheme WindowControlTitleBar}">
			<Setter Property="RightContentTemplate">
				<DataTemplate>

					<!-- Avatar -->
					<actipro:Avatar Width="20" Margin="10,0" />

				</DataTemplate>
			</Setter>
		</ControlTheme>
	</actipro:WindowControl.TitleBarTheme>

	...

</actipro:WindowControl>

Refer to the ChromedTitleBar topic for more details about title bar capabilities.