Up
Authors
- Ovidiu Predescu (
ovidiu@net-community.com)
-
- Felipe A. Rodriguez (
far@ix.netcom.com)
-
Copyright: (C) 1996 Free Software Foundation, Inc.
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.
- Declared in:
- AppKit/NSSlider.h
Availability: OpenStep
Description forthcoming.
Method summary
- (BOOL)
acceptsFirstMouse: (
NSEvent*)theEvent;
Availability: OpenStep
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.
- (BOOL)
allowsTickMarkValuesOnly;
Availability: MacOS-X 10.0.0
Description forthcoming.
- (double)
altIncrementValue;
Availability: OpenStep
Returns the value by which the slider will be
incremented if the user holds down the ALT
key.
See Also:
-setAltIncrementValue:
- (double)
closestTickMarkValueToValue: (double)aValue;
Availability: MacOS-X 10.0.0
Description forthcoming.
- (
NSImage*)
image;
Availability: OpenStep
Returns the image drawn in the slider's track.
Returns nil if this has not been
set.
See Also:
-setImage:
- (
NSInteger)
indexOfTickMarkAtPoint: (
NSPoint)point;
Availability: MacOS-X 10.0.0
Description forthcoming.
- (
NSInteger)
isVertical;
Availability: OpenStep
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.
- (
CGFloat)
knobThickness;
Availability: OpenStep
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.
- (double)
maxValue;
Availability: OpenStep
Returns the maximum value that the slider
represents.
See Also:
-setMaxValue:
- (double)
minValue;
Availability: OpenStep
Returns the minimum value that the slider
represents.
See Also:
-setMinValue:
- (
NSInteger)
numberOfTickMarks;
Availability: MacOS-X 10.0.0
Description forthcoming.
- (
NSRect)
rectOfTickMarkAtIndex: (
NSInteger)index;
Availability: MacOS-X 10.0.0
Description forthcoming.
- (void)
setAllowsTickMarkValuesOnly: (BOOL)flag;
Availability: MacOS-X 10.0.0
Description forthcoming.
- (void)
setAltIncrementValue: (double)increment;
Availability: OpenStep
Sets the value by which the slider will be
incremented, when the ALT key is held down,
to increment.
See Also:
-altIncrementValue
- (void)
setImage: (
NSImage*)backgroundImage;
Availability: OpenStep
Sets the image to be displayed in the slider's track
to barImage.
See Also: -image
- (void)
setKnobThickness: (
CGFloat)aFloat;
Availability: OpenStep
Sets the thickness of the knob to aFloat,
in pixels. This value sets the amount of space which
the knob takes up in the slider's track.
See Also:
-knobThickness
- (void)
setMaxValue: (double)aDouble;
Availability: OpenStep
Sets the maximum value that the sliders represents
to aDouble.
See Also:
-maxValue
- (void)
setMinValue: (double)aDouble;
Availability: OpenStep
Sets the minimum value that the slider represents to
aDouble.
See Also:
-minValue
- (void)
setNumberOfTickMarks: (
NSInteger)numberOfTickMarks;
Availability: MacOS-X 10.0.0
Description forthcoming.
- (void)
setTickMarkPosition: (
NSTickMarkPosition)position;
Availability: MacOS-X 10.0.0
Description forthcoming.
- (void)
setTitle: (
NSString*)aString;
Availability: OpenStep
Sets the title of the slider to aString.
This title is displayed on the slider's track,
behind the knob.
See Also: -title
- (void)
setTitleCell: (
NSCell*)aCell;
Availability: OpenStep
Sets the cell used to draw the title to
aCell.
See Also:
-titleCell
- (void)
setTitleColor: (
NSColor*)aColor;
Availability: OpenStep
Sets the colour with which the title will be drawn
to aColor.
See Also
-titleColor
- (void)
setTitleFont: (
NSFont*)fontObject;
Availability: OpenStep
Sets the font with which the title will be drawm to
fontObject.
See Also:
-titleFont
- (
NSTickMarkPosition)
tickMarkPosition;
Availability: MacOS-X 10.0.0
Description forthcoming.
- (double)
tickMarkValueAtIndex: (
NSInteger)index;
Availability: MacOS-X 10.0.0
Description forthcoming.
- (
NSString*)
title;
Availability: OpenStep
Returns the title of the slider as an
NSString.
See Also:
-setTitle:
- (id)
titleCell;
Availability: OpenStep
- (
NSColor*)
titleColor;
Availability: OpenStep
- (
NSFont*)
titleFont;
Availability: OpenStep
Up