FramelessWindow QML Type
A frameless application window with Mica or Acrylic background. More...
| Import Statement: | import FluentUI.Controls 1.0 |
Properties
- appBar : AppBar
- autoDestroy : bool
- background : Component
- containerItem : Item
- fitsAppBarWindows : bool
- fixSize : bool
- framelessHelper : Frameless
- initialItem : var
- launchMode : int
- title : string
- topmost : bool
- windowEffect : int
Signals
Methods
- void setHitTestVisible(id)
- void showMaximized()
- void showMinimized()
- void showNormal()
Detailed Description
FramelessWindow provides a fully customizable window without the standard operating system chrome. It supports Mica and Acrylic background effects, an integrated AppBar, configurable launch modes, and size constraints. It is the primary top-level container for FluentUI applications.
Property Documentation
appBar : AppBar
The AppBar instance used as the window title bar.
autoDestroy : bool
Whether the window is automatically destroyed when closed. Defaults to true.
background : Component
A Component that creates the window background visual.
containerItem : Item
The root container item for the window content.
fitsAppBarWindows : bool
Whether the window layout accounts for the AppBar area to avoid content overlap.
fixSize : bool
Whether the window size is fixed and cannot be resized by the user.
framelessHelper : Frameless
The native frameless helper object that manages window chrome and hit testing.
initialItem : var
The QML component or URL to load as the initial content of the window.
launchMode : int
The launch mode for the window. Can be used to control single-instance or multi-instance behavior.
title : string
The window title text.
topmost : bool
Whether the window always stays on top of other windows.
windowEffect : int
The type of background window effect. Can be Mica, Acrylic, or none.
Signal Documentation
void init(var argument)
Emitted when the window is initialized with a launch argument.
Note: The corresponding handler is onInit.
void newInit(var argument)
Emitted when the window receives a new launch argument after it has already been initialized.
Note: The corresponding handler is onNewInit.
Method Documentation
void setHitTestVisible(id)
Registers the item with the given id as a hit-test visible area, allowing it to receive mouse events even in the non-client window region.
void showMaximized()
Maximizes the window.
void showMinimized()
Minimizes the window.
void showNormal()
Restores the window to its normal size.