Copyright ©1995 by NeXT Computer, Inc.  All Rights Reserved.

NXColorPicker



Inherits From: Object
Conforms To: NXColorPickingDefault
Declared In: appkit/NXColorPicker.h



Class Description

NXColorPicker is an abstract superclass that implements the NXColorPickingDefault protocol.  The NXColorPickingDefault and NXColorPickingCustom protocols define a way to add color pickers--custom user interfaces for color selection--to the NXColorPanel.  The simplest way to implement a color picker is to create a subclass of NXColorPicker that implements the NXColorPickingCustom protocol.

The NXColorPickingDefault protocol specification describes the details of implementing a color picker and adding it to your application's NXColorPanel; you should turn there first for an overview of how NXColorPicker works.  This specification is provided to document the specific behavior of NXColorPicker's methods.



Adopted Protocols

NXColorPickingDefault initFromPickerMask:withColorPanel:
provideNewButtonImage
insertNewButtonImage:in:
viewSizeChanged:
alphaControlAddedOrRemoved:
insertionOrder
attachColorList:
detachColorList:
updateColorList:
setMode:



Instance Variables

id imageObject

NXColorPanel *colorPanel

BOOL continuous


imageObject Object providing the ButtonCell image
colorPanel Panel in which the color picker is installed
continuous YES if color picker updates current color continuously



Instance Methods

alphaControlAddedOrRemoved:
alphaControlAddedOrRemoved:sender

Does nothing and returns self.



attachColorList:
attachColorList:colorList

Does nothing and returns self.



detachColorList:
detachColorList:colorList

Does nothing and returns self.



insertionOrder
(float)insertionOrder

Returns 0.4, a value that places NXColorPicker's ButtonCell first in the Matrix from which the user selects color pickers.

See also:  insertNewButtonImage:in:, provideNewButtonImage:



insertNewButtonImage:in:
insertNewButtonImage:newImage in:newButtonCell

Sets newImage as newButtonCell's image by invoking ButtonCell's setImage: method.  Returns self.



initFromPickerMask:withColorPanel:
initFromPickerMask:(int)theMask withColorPanel:thePanel

Sets the color picker's color panel to thePanel and returns self.  Override this method to respond to the values in theMask or do other custom initialization.  If you override this method in a subclass, you should forward the message to super as part of the implementation.



provideNewButtonImage
provideNewButtonImage

Returns the NXImage that represents the NXColorPicker in the NXColorPanel's Matrix of ButtonCells.  This method attempts to load the image from a file named MyPickerClass.tiff (where MyPickerClass is the name of your subclass of NXColorPicker) in the MyPickerClass bundle of the application's ColorPicker directory.  See "Color Picker Bundles" in the NXColorPickingDefault protocol specification for a more complete discussion of this bundle.



setMode:
setMode:(int)mode

Does nothing and returns self.  Override this method if your color picker has submodes to set the mode of the color picker to mode.



updateColorList:
updateColorList:colorList

Does nothing and returns self.



viewSizeChanged:
viewSizeChanged:sender

Does nothing and returns self.