|Type||Topic||Plugin||Version||macOS||Windows||Linux||Console & Web||iOS|
|class||Cocoa||MBS MacExtras Plugin||14.3||Yes||No||No||Yes, macOS only||No|
An NSAppearance object represents a file that specifies a standard or custom appearance that applies to a subset of UI elements in an app. An app can contain multiple appearance files and—because NSAppearance conforms to NSCoding—you can use Interface Builder to assign UI elements to an appearance.
Typically, you customize a window by using Xcode to create an appearance file that contains the views you want to customize and the custom art that should be applied to them. Xcode transforms the file’s art content into a runtime format that AppKit can draw when the specified views are displayed.
If the art for a specific view can’t be found, AppKit searches for the art in the appearances of the view’s ancestors. A nil appearance means that a view uses the default Aqua appearance; a non-nil appearance means that the view uses an ancestor’s appearance.
When AppKit draws a control, it automatically sets the current appearance on the current thread to the control’s appearance. The current appearance can influence the actual drawing path and the return values you get when you access system fonts and colors. The current appearance also affects the appearance of text and images, such as the text and template images that can be displayed in a toolbar.
This is an abstract class. You can't create an instance, but you can get one from various plugin functions.
- 3 properties
- method Constructor
- 12 shared methods
- shared method appearance(item as Variant) as NSAppearanceMBS
- shared method appearanceNamed(name as string) as NSAppearanceMBS
- shared method appearanceNamed(name as string, bundle as NSBundleMBS) as NSAppearanceMBS
- shared method Available as boolean
- shared method currentAppearance as NSAppearanceMBS
- shared method effectiveAppearance(item as Variant) as NSAppearanceMBS
- shared method NSAppearanceNameAqua as string
- shared method NSAppearanceNameLightContent as string
- shared method NSAppearanceNameVibrantDark as string
- shared method NSAppearanceNameVibrantLight as string
- shared method setAppearance(item as Variant, appearance as NSAppearanceMBS)
- shared method setCurrentAppearance(appearance as NSAppearanceMBS = nil)
This class has no sub classes.
Some examples which use this class:
The items on this page are in the following plugins: MBS MacExtras Plugin.
MBS Xojo tutorial videos