Registers the receiver under the specified name.
SDK
- macOS 10.0+
Framework
- App
Kit
Declaration
Parameters
aString
The name to associate with the receiver. Specify
nil
if you want to remove the image from the image cache.
Return Value
true
if the receiver was successfully registered with the given name; otherwise, false
.
Discussion
If the receiver is already registered under a different name, this method unregisters the other name. If a different image is already registered under the name specified in a
, this method does nothing and returns false
.
When naming an image using this method, it is convention not to include filename extensions in the names you specify. That way, you can easily distinguish between images you have named explicitly and those you want to load from the app's bundle. For information about the rules used to search for images, and for information about the ownership policy of named images, see the init(named:)
method.