# NSColorList

scottc@net-community.com
n.pero@mi.flashnet.it
Generated at 2026-02-17 21:02:56 +0000

Manage named lists of NSColors.

1996, 2000 Free Software Foundation, Inc.
Software documentation for the NSColorList class
AppKit/NSColorList.h
NSCoding
Description forthcoming.
Warning the underscore at the start of the name of this instance variable indicates that, even though it is not technically private, it is intended for internal use within the package, and you should not use the variable in other code.
Warning the underscore at the start of the name of this instance variable indicates that, even though it is not technically private, it is intended for internal use within the package, and you should not use the variable in other code.
Warning the underscore at the start of the name of this instance variable indicates that, even though it is not technically private, it is intended for internal use within the package, and you should not use the variable in other code.
Warning the underscore at the start of the name of this instance variable indicates that, even though it is not technically private, it is intended for internal use within the package, and you should not use the variable in other code.
Warning the underscore at the start of the name of this instance variable indicates that, even though it is not technically private, it is intended for internal use within the package, and you should not use the variable in other code.
availableColorLists
Description forthcoming.
colorListNamed:
name
Returns the first color list (from the array of available lists) matching name.
allKeys
Returns an array containing all the keyus in the color list
colorWithKey:
key
Returns the color for the specified key (if any).
encodeWithCoder:
aCoder
Description forthcoming.
initWithCoder:
aDecoder
Description forthcoming.
initWithName:
name
Initializes a new, empty color list registered under given name.
initWithName:
name
fromFile:
path

Initializes a new color list registered under given name, taking contents from the file specified in path. (Path should include the filename with extension (usually ".clr"), and by convention name should be the same as filename without the extension.)

The format of the file can be either an archive of an NSColorList or an ASCII format. ASCII files follow this format:

first line = [#/colors]
each subsequent line describes a color as [int float+ string]
the first int describes the method (RGBA, etc.), the floats provide its arguments (e.g., r, g, b, alpha), and string is name.

The method corresponds to one of the NSColor initializers. We are looking for documentation of the exact correspondence on OpenStep; for now the only supported method is "0", which is an RGBA format with the arguments in order R,G,B, A.

insertColor:
color
key:
key
atIndex:
location
Inserts a color into the color list at the specified index. Removes any other color with the same name.
isEditable
Returns a flag indicating whether the receiver is editable.
name
Returns the name of the receiver.
removeColorWithKey:
key
Removes the color for the specified key from the list.
removeFile
Removes the on-disk representation of the list.
setColor:
aColor
forKey:
key
Sets the color for this key and appends it to the color list.
writeToFile:
path
Writes the receiver to the specified path .
If path is `nil`, writes to a file located in the current user's personal Colors directory whose name is that of the list with the extension 'clr' appended.
If path is a directory, writes to a file in that directory whose name is that of the list with the extension 'clr' appended.
Otherwise ( path is neither `nil` nor a directory), writes to the path without appending the l.ist name.
Returns `YES` on success, `NO` on failure.
Writing with a path of `nil` will cause the receiver to be added to the +availableColorLists if it is not already there.