Instance Method

setName:

Registers the receiver under the specified name.

Declaration

- (BOOL)setName:(NSImageName)string;

Parameters

aString

The name to associate with the receiver. Specify nil if you want to remove the image from the image cache.

Return Value

YES if the receiver was successfully registered with the given name; otherwise, NO.

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 aString, this method does nothing and returns NO.

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 imageNamed: method.

See Also

Creating Images by Name

+ imageNamed:

Returns the image object associated with the specified name.

- name

Returns the name associated with the image, if any.

NSImageName

Named images, defined by the system or you, for use in your app.