Add-ons
  • Welcome
  • StackView
    • Version 2
      • How it works
      • How to use it
      • The Details
        • ScrollController
        • StackController
        • ViewController
      • Tips & Tricks
      • General Information
    • Version 3
      • How it works
      • How to use it
      • The Details
        • ScrollController
        • StackController
        • ViewController
      • Tips & Tricks
      • General Information
    • Changelogs
    • Purchase
  • FTC Word-Exporter
    • How to use it
    • General Information
  • CSTrueColors
    • Documentation
      • NSColorAddition
      • AppKitAddition
        • VisualEffectView
      • User32Addition
      • Template Images
      • The Demo Project
    • Changelog
  • Android
  • Open Source Projects
    • Android Design Extensions
  • Xojo Language Guide
    • The Basics
Powered by GitBook
On this page
  • Overview
  • Methods
  • Properties
  • Enumerations
  • Documentation
  • Methods
  • Properties
  • Enumerations
  1. CSTrueColors
  2. Documentation
  3. AppKitAddition

VisualEffectView

A background control that adds translucency and vibrancy effects to the GUI.

PreviousAppKitAdditionNextUser32Addition

Last updated 8 months ago

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

Methods

Overview

Properties

Overview

Enumerations

Overview

Documentation

Methods

Constructor(x As Double, y As Double, w As Double, h As Double)

Creates a new VisualEffectView in code. Keep in mind that on macOS the y axis is reversed!

Properties

Specifies how the view’s contents are blurred. Default is BehindWindow.

Emphasized As Boolean

If the view should draw in "first responder" status, or not. Available since macOS 10.12.

The view’s interior background style. (read-only)

MaskImage As Picture

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.

Enumerations

NSVisualEffectBlendingMode

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.

NSVisualEffectMaterial

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.

NSVisualEffectState

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.

BlendingMode As

InteriorBackgroundStyle As

Material As

State As

NSVisualEffectBlendingMode
NSVisualEffectMaterial
NSVisualEffectState
Constructor
BlendingMode
Emphasized
InteriorBackgroundStyle
MaskImage
Material
State
NSVisualEffectBlendingMode
NSVisualEffectMaterial
NSVisualEffectState
AppKitAddition.NSBackgroundStyle
All available materials of VisualEffectView