Named images, defined by the system or you, for use in your app.
- macOS 10.13+
- Mac Catalyst 13.0+
The appearance of system-supplied images can change between releases. If you use an image for its intended purpose (and not because of how it looks), your code should look correct from release to release.
The size and aspect ratio of system images can also change between releases. In some situations, you should explicitly resize images as appropriate for your use. If you use these images in conjunction with an
NSButton object, however, you can use the
image property of the cell to control scaling instead. Similarly, for an
NSSegmented object, you can use the
set: method to control scaling.
Constants that end in the word "Template" represent template images. These images can be processed into variants appropriate for different situations. For example, these images can invert in a selected table view row. See
is for more information.
Some images also contain the word "FreestandingTemplate". These images are template images that are appropriate for use as a borderless button—that is, it doesn't need any extra bezel artwork behind it.