Class / Control
Inherits from View
macOS only! Becomes a normal Canvas on other systems.
Usually you drag a VisualEffectView onto the IDE, set its properties there and place controls on it. For experiments with custom controls, the class has a Constructor method too.
Overview | |
|
Creates a new VisualEffectView in code. Keep in mind that on macOS the y axis is reversed!
Specifies how the view’s contents are blurred. Default is BehindWindow.
If the view should draw in "first responder" status, or not. Available since macOS 10.12.
The view’s interior background style. (read-only)
An image whose alpha channel masks the visual effect view's material.
The material shown by the visual effect view. Please note several items have been deprecated and several new ones added with macOS Mojave.
Whether a view has a visual effect applied.
A value indicating how the view’s contents blend with the surrounding content. Values:
Value | Definition |
BehindWindow | A mode that blends and blurs the visual effect view with the contents behind the window, such as the desktop or other windows. |
WithinWindow | A mode that blends and blurs the visual effect view with contents behind the view in the current window only. |
The material shown by the visual effect view. Deprecations and additions since macOS 10.14. Values:
Value | Definition |
AppearanceBased_Deprecated | A default material for the view’s effective appearance. |
Light_Deprecated | A material with a light effect. |
Dark_Deprecated | A material with a dark effect. |
Titlebar | The material for a window’s titlebar. |
Selection | The material used to indicate a selection. |
Menu | The material for menus. |
Popover | The material for the background of popover windows. |
Sidebar | The material for the background of window sidebars. |
MediumLight_Deprecated | A material with a medium-light effect. |
UltraDark_Deprecated | A material with a medium-light effect. |
HeaderView | The material for in-line header or footer views. |
Sheet | The material for the background of sheet windows. |
WindowBackground | The material for the background of opaque windows. |
HUDWIndow | The material for the background of heads-up display (HUD) windows. |
FullScreenUI | The material for the background of a full-screen modal interface. |
ToolTip | The material for the background of a tool tip. |
ContentBackground | The material for the background of opaque content. |
UnderWindowBackground | The material for under a window's background. |
UnderPageBackground | The material for the area behind the pages of a document. |
A value that indicates whether and when a view has a visual effect applied. Values:
Value | Definition |
FollowsWindowActiveState | The backdrop should automatically appear active when the window is active, and inactive when it is not. |
Active | The backdrop should always appear active. |
Inactive | The backdrop should always appear inactive. |