Platforms to show: All Mac Windows Linux Cross-Platform

NSImageSymbolConfigurationMBS class

Type Topic Plugin Version macOS Windows Linux iOS Targets
class Cocoa Drawing MBS MacBase Plugin 22.1 ✅ Yes ❌ No ❌ No ✅ Yes All
An object that contains the specific font, style, and weight attributes to apply to a symbol image.
Var config As NSImageSymbolConfigurationMBS = NSImageSymbolConfigurationMBS.configurationWithPointSize(40, 0)
Var n As NSImageMBS = NSImageMBS.imageWithSystemSymbolName("trash")
Var o As NSImageMBS = n.imageWithSymbolConfiguration(config)

Backdrop = o.CopyPictureWithAlpha

Symbol image configuration objects include details such as the point size, scale, text style, and weight to apply to your symbol image. The system uses these details to determine which variant of the image to use and how to scale or style the image.

NSImageSymbolConfiguration objects are immutable after you create them. If you use the configurationByApplyingConfiguration method on the object, the new image attributes replace any previous attributes you supplied. After creating a symbol configuration object, assign it to the symbolConfiguration property of the NSImageViewMBS object you use to display the image. If you draw the image directly, use the imageWithSymbolConfiguration method to create a new image that contains the new attributes.

For design guidance, see Human Interface Guidelines.
This is an abstract class. You can't create an instance, but you can get one from various plugin functions.


Constant Value Description
kSymbolScaleLarge 3 Specifies which scale variant of a symbol image to use. The symbol uses the large scale variant.
This scale is approximately 30% larger than the kSymbolScaleMedium scale.
kSymbolScaleMedium 2 Specifies which scale variant of a symbol image to use. The symbol uses the default medium scale variant.
kSymbolScaleSmall 1 Specifies which scale variant of a symbol image to use. The symbol uses the small scale variant.
This scale is approximately 20% smaller than the kSymbolScaleMedium scale.

This class has no sub classes.

Some methods using this class:

Some properties using for this class:

Blog Entries

Xojo Developer Magazine

Release notes

The items on this page are in the following plugins: MBS MacBase Plugin.

NSImageRepMBS   -   NSImageViewMBS

The biggest plugin in space...