CubicSlider.rtf

This is CubicSlider.rtf in view mode; [Download] [Up]

Release 1.4 by Raymond Lutz, 24 juin 1993.

CubicSlider

INHERITS FROM Slider: Control : View : Responder : Object

DECLARED IN CubicSlider.h

CLASS DESCRIPTION

As Sliders, CubicSliders are Controls that have a sliding knob that can be moved to represent a value between a minimum and a maximum. In addition, this subclass allows the user to interactively set those extremum values by double-clicking on the knob. Different actions can then be taken:

either the user narrows the slider range

- entering a superior minimum value (or an inferior maximum) in a small form popped over the slider, or

- pushing a button identified with a NXscrollMenuDown icon which function is to use for the new
extremum value the current slider value, as set just before the double-click;

or either he enlarges the slider range

- entering an inferior minimum value (or a superior maximum) in the small form, or

- pushing a button identified with a NXscrollMenuRight (NXscrollMenuLeft) icon which function is to
quadruple the current range and place the added interval at the specified extremity.

Double-clicking on the left half of the knob will designate the minimum value as the one to be modified and, inversely, double-clicking on its right half will designate the maximum value. To exit edit mode without any modification simply press enter, the unchanged selected text in the form will be taken as the extremum value.

Also, an added mechanism allows a precise control of the slider value. When inquired about its value (with a doubleValue, floatValue or intValue message), the slider takes the knob position, passes it through a cubic transfer function and returns this transformed value: since a flat region surrounds the initial knob position, large moves give small output value variations, thus an increased resolution is attained. The polynomial is redefined after each mouseUp so its flat region still surrounds the new value selected by the user. The user can toggle between this behavior and the normal one by ALT double-clicking the slider.

CubicSlider (and an accompanying CubicSliderCell) can be dragged into your application from Interface Builder's Palettes panel, and its attributes set by Inspector panels.

INSTANCE VARIABLES

Inherited from Object Class isa;

Inherited from Responder id nextResponder;

Inherited from View NXRect frame;
NXRect bounds;
id superview;
id subviews;
id window;
struct __vFlags vFlags;

Inherited from Control int tag;
id cell;
struct _conFlags conFlags;

Declared in CubicSlider (none)

METHOD TYPES

Initializing a new slider instance � initFrame:

Setting CubicSlider Values - doubleValue
- floatValue
- intValue
- linearDoubleValue
- linearFloatValue
- linearIntValue
- maxValue
- minValue
- setDoubleValue:
- setFloatValue:
- setIntValue:
- setMaxValue:
- setMinValue:

Setting Transfer Function - setCubic:
- isCubic

Setting User Access - setMinEditable
- minIsEditable
- setMaxEditable
- maxIsEditable

Setting Absolute Range - setAbsoluteMinValue
- absoluteMinValueSet
- absoluteMinValue
- clearAbsoluteMinValue

- setAbsoluteMaxValue
- absoluteMaxValueSet
- absoluteMaxValue
- clearAbsoluteMaxValue

Targets And Actions - upAction
- setUpAction:
- upTarget:
- setUpTarget:
- setUpTarget:action:

INSTANCE METHODS

initFrame:
� initFrame:(const NXRect *)frameRect

Initializes and returns the receiver, a new instance of CubicSlider. The slider must be horizontal and frameRect wider than it is high; otherwise it will not work... By default, the slider is continuous and cubic. After initializing the slider, invoke the sizeToFit method to resize the slider to accommodate its knob. This method is the designated initializer for the CubicSlider class.

setEnabled:
- setEnabled:(BOOL)flag

If flag is YES, enables the CubicSlider; if NO, disables the CubicSlider. Redraws the interior of the CubicSlider if autodisplay is on and the enabled state has changed. Returns self.

minValue
- (double)minValue

Returns the minimum value of the CubicSlider.

setMinValue:
- setMinValue:(double)aDouble

Sets the minimum value of the CubicSlider. If aDouble conflicts with a set absoluteMinValue (being smaller) then absoluteMinValue will also be set to this specified minimum value. Returns self.