Class Description
An NSSlider displays, and allows control of, some value in
the application. It represents a continuous stream of
values of type float, which can be
retrieved by the method floatValue and
set by the method setFloatValue:.
This control is a continuous control. It sends its action
message as long as the user is manipulating it. This
can be changed by passing NO to the
setContinuous: message of a given NSSlider.
Although methods for adding and managing a title are
provided, the slider's knob can cover this title, so
it is recommended that a label be added near the slider, for
identification.
As with many controls, NSSlider relies on its cell
counterpart, NSSliderCell. For more information,
please see the specification for NSSliderCell.
Use of an NSSlider to do the role of an NSScroller is not
recommended. A scroller is intended to represent
the visible portion of a view, whereas a slider is intended
to represent some value.
AppKit/NSSlider.h
acceptsFirstMouse:
theEvent
Returns YES by default. This will
allow the first click sent to the slider, when in an
inactive window, to both bring the window into
focus and manipulate the slider.
allowsTickMarkValuesOnly
altIncrementValue
Returns the value by which the slider will be
incremented if the user holds down the ALT key.
closestTickMarkValueToValue:
aValue
image
Returns the image drawn in the slider's track.
Returns nil if this has not been set.
indexOfTickMarkAtPoint:
point
isVertical
Returns whether or not the slider is vertical. If,
for some reason, this cannot be determined, for such
reasons as the slider is not yet displayed, this
method returns -1. Generally, a slider is considered
vertical if its height is greater than its width.
knobThickness
Returns the thickness of the slider's knob. This
value is in pixels, and is the size of the knob along
the slider's track.
maxValue
Returns the maximum value that the slider
represents.
minValue
Returns the minimum value that the slider
represents.
numberOfTickMarks
rectOfTickMarkAtIndex:
index
setAllowsTickMarkValuesOnly:
flag
setAltIncrementValue:
increment
Sets the value by which the slider will be
incremented, when the ALT key is held down, to
increment.
setImage:
backgroundImage
Sets the image to be displayed in the slider's track
to barImage.
setKnobThickness:
aFloat
Sets the thickness of the knob to thickness
, in pixels. This value sets the amount of space which
the knob takes up in the slider's track.
setMaxValue:
aDouble
Sets the maximum value that the sliders represents to
maxValue.
setMinValue:
aDouble
Sets the minimum value that the slider represents to
minValue.
setNumberOfTickMarks:
numberOfTickMarks
setTickMarkPosition:
position
setTitle:
aString
Sets the title of the slider to barTitle.
This title is displayed on the slider's track, behind
the knob.
setTitleCell:
aCell
Sets the cell used to draw the title to
titleCell.
setTitleColor:
aColor
Sets the colour with which the title will be drawn to
color.
setTitleFont:
fontObject
Sets the font with which the title will be drawm to
font.
tickMarkPosition
tickMarkValueAtIndex:
index
title
Returns the title of the slider as an
NSString.
titleCell
Returns the cell used to draw the title.
titleColor
Returns the colour used to draw the title.
titleFont
Returns the font used to draw the title.