Class Window

An in-game window.

Inheritance
object
Widget
Window
Implements
Inherited Members
Namespace: SociallyDistant.Core.Shell.Windowing
Assembly: SociallyDistant.Framework.dll
Syntax
public sealed class Window : Widget, IFontFamilyProvider, IInspectable, IWindow, IVisual<Window.VisualState>, IUpdateThemeProperties, IMouseDownHandler, IDragStartHandler, IDragHandler, IDragEndHandler, IMouseHandler

Constructors

Window(IWindowGroup)

Creates a new instance of the Window widget.

Declaration
public Window(IWindowGroup windowGroup)
Parameters
Type Name Description
IWindowGroup windowGroup

An implementation of IWindowGroup representing the workspace to which this window belongs.

Properties

AllowResizing

Gets or sets a value indicating whether the window may be resized by the user. Must be true to allow maximization.

Declaration
public bool AllowResizing { get; set; }
Property Value
Type Description
bool

ClientArea

Gets an instance of ContentWidget representing the window's content area. This area is where the window's main content may be placed.

Declaration
public ContentWidget ClientArea { get; }
Property Value
Type Description
ContentWidget

CloseButtonBehaviour

Gets the behaviour of the window's close button.

Declaration
public CaptionButtonStyle CloseButtonBehaviour { get; set; }
Property Value
Type Description
CaptionButtonStyle

DesiredPosition

Gets or sets the desired position within its current window group.

Declaration
public Point DesiredPosition { get; set; }
Property Value
Type Description
Point

Hints

Gets a WindowHints value indicating any current window hints assigned to this window.

Declaration
public WindowHints Hints { get; }
Property Value
Type Description
WindowHints

Icon

Gets or sets a CompositeIcon value to use as the window's icon. If set to null, the window won't have an icon.

Declaration
public CompositeIcon? Icon { get; set; }
Property Value
Type Description
CompositeIcon?

IconVisibility

Gets or sets the visibility of the window's icon. If you want to visually hide the icon, you should set this value to Collapsed instead of not assigning a value for the window's Icon.

Declaration
public Visibility IconVisibility { get; set; }
Property Value
Type Description
Visibility

Maximized

Gets or sets a value indicating whether the window should be maximized.

Declaration
public bool Maximized { get; set; }
Property Value
Type Description
bool

MinimizeButtonBehaviour

Gets or sets the behaviour of the window's minimize button.

Declaration
public CaptionButtonStyle MinimizeButtonBehaviour { get; set; }
Property Value
Type Description
CaptionButtonStyle

ResizeButtonBehaviour

Gets or sets the behaviour of the window's maximize/restore button.

Declaration
public CaptionButtonStyle ResizeButtonBehaviour { get; set; }
Property Value
Type Description
CaptionButtonStyle

Title

Gets or sets the window's title. If set to null or an empty string, a default title of "Window" is used instead.

Declaration
public string? Title { get; set; }
Property Value
Type Description
string

TitleVisibility

Gets or sets the visibility of the window's title.

Declaration
public Visibility TitleVisibility { get; set; }
Property Value
Type Description
Visibility

UserDefinedArea

Gets an instance of ContentWidget representing an area in the window's decorations where user-defined content can be placed. This is where toolbars, headerbars, and other non-content widgets can be placed.

Declaration
public ContentWidget UserDefinedArea { get; }
Property Value
Type Description
ContentWidget

VisualProperties

Gets a read-only reference to the visual properties associated with the widget.

Declaration
public ref readonly Window.VisualState VisualProperties { get; }
Property Value
Type Description
Window.VisualState

Methods

ArrangeChildren(IGuiContext, LayoutRect)

Declaration
protected override void ArrangeChildren(IGuiContext context, LayoutRect availableSpace)
Parameters
Type Name Description
IGuiContext context
LayoutRect availableSpace
Overrides

BeforeRender()

Declaration
protected override void BeforeRender()
Overrides

Close()

Immediately close this window, without waiting for user confirmation.

Declaration
public void Close()

GetContentSize(Point)

Declaration
protected override Point GetContentSize(Point availableSize)
Parameters
Type Name Description
Point availableSize
Returns
Type Description
Point
Overrides

OnDrag(MouseButtonEvent)

Declaration
public void OnDrag(MouseButtonEvent e)
Parameters
Type Name Description
MouseButtonEvent e

OnDragEnd(MouseButtonEvent)

Declaration
public void OnDragEnd(MouseButtonEvent e)
Parameters
Type Name Description
MouseButtonEvent e

OnDragStart(MouseButtonEvent)

Declaration
public void OnDragStart(MouseButtonEvent e)
Parameters
Type Name Description
MouseButtonEvent e

OnMouseDown(MouseButtonEvent)

Declaration
public void OnMouseDown(MouseButtonEvent e)
Parameters
Type Name Description
MouseButtonEvent e

RebuildGeometry(GeometryHelper)

Declaration
protected override void RebuildGeometry(GeometryHelper geometry)
Parameters
Type Name Description
GeometryHelper geometry
Overrides

SetWindowHints(WindowHints)

Set window hints that control behaviour and visual appearance of the window.

Declaration
public void SetWindowHints(WindowHints windowHints)
Parameters
Type Name Description
WindowHints windowHints

The new hints to apply.

UpdateThemeProperties()

Retrieves layout properties from the visual style. Called by the UI system on every frame before layout updates occur. If layout properties change during this method call, the widget will automatically invalidate its own layout.

Declaration
public void UpdateThemeProperties()

Events

WindowClosed

Event that's fired when the window is closed.

Declaration
public event Action<IWindow>? WindowClosed
Event Type
Type Description
Action<IWindow>

Implements