---

NSStepper Class Reference

Overview

A stepper consists of two small arrows that can increment and decrement a value that appears beside it, such as a date or time. The illustration below shows a stepper to the right of a text field, which would show the stepper’s value.

The NSStepper class uses the NSStepperCell class to implement its user interface.

Tasks

Specifying Value Range

• – maxValue
• – setMaxValue:
• – minValue
• – setMinValue:
• – increment
• – setIncrement:

Specifying How the Stepper Responds

• – autorepeat
• – setAutorepeat:
• – valueWraps
• – setValueWraps:

Instance Methods

autorepeat

Returns a Boolean value indicating how the receiver responds to mouse events.

- (BOOL)autorepeat

Return Value

YES if the first mouse down does one increment (or decrement) and, after a delay of 0.5 seconds, increments (or decrements) at a rate of ten times per second. NO if the receiver does one increment (decrement) on a mouse up. The default is YES.

Availability

• Available in Mac OS X v10.0 and later.

See Also

• – setAutorepeat:

Declared In

NSStepper.h

increment

Returns the amount by which the receiver will change per increment (decrement).

- (double)increment

Return Value

The amount by which the receiver changes with each increment or decrement. The default is 1.

Availability

• Available in Mac OS X v10.0 and later.

See Also

• – setIncrement:

Declared In

NSStepper.h

maxValue

Returns the maximum value for the receiver.

- (double)maxValue

Return Value

The maximum value. The default is 59.

Availability

• Available in Mac OS X v10.0 and later.

See Also

• – setMaxValue:

Declared In

NSStepper.h

minValue

Returns the minimum value for the receiver.

- (double)minValue

Return Value

The minimum value. The default is 0.

Availability

• Available in Mac OS X v10.0 and later.

See Also

• – setMinValue:

Declared In

NSStepper.h

setAutorepeat:

Sets how the receiver responds to mouse events.

- (void)setAutorepeat:(BOOL)autorepeat

Parameters

autorepeat

If YES, the first mouse down does one increment (decrement) and, after a delay of 0.5 seconds, increments (decrements) at a rate of ten times per second. If autorepeat is NO, the receiver does one increment (decrement) on a mouse up.

Availability

• Available in Mac OS X v10.0 and later.

See Also

• – autorepeat

Declared In

NSStepper.h

setIncrement:

Sets the amount by which the receiver will change per increment (decrement).

- (void)setIncrement:(double)increment

Parameters

increment

The amount by which the receiver changes with each decrement or increment.

Availability

• Available in Mac OS X v10.0 and later.

See Also

• – increment

Declared In

NSStepper.h

setMaxValue:

Sets the maximum value for the receiver

- (void)setMaxValue:(double)maxValue

Parameters

maxValue

The new maximum value.

Availability

• Available in Mac OS X v10.0 and later.

See Also

• – maxValue

Declared In

NSStepper.h

setMinValue:

Sets the minimum value for the receiver

- (void)setMinValue:(double)minValue

Parameters

minValue

The new minimum value.

Availability

• Available in Mac OS X v10.0 and later.

See Also

• – minValue

Declared In

NSStepper.h

setValueWraps:

Sets whether the receiver wraps around the minimum and maximum values.

- (void)setValueWraps:(BOOL)valueWraps

Parameters

valueWraps

If YES, then when incrementing or decrementing, the value wraps around to the minimum or maximum. If valueWraps is NO, the value stays pinned at the minimum or maximum.

Availability

• Available in Mac OS X v10.0 and later.

See Also

• – valueWraps

Declared In

NSStepper.h

valueWraps

Returns a Boolean value indicating whether the receiver wraps around the minimum and maximum values.

- (BOOL)valueWraps

Return Value

YES if, when incrementing or decrementing, the value wraps around to the minimum or maximum. NO if the value stays pinned at the minimum or maximum. The default is YES.

Availability

• Available in Mac OS X v10.0 and later.

See Also

• – setValueWraps:

Declared In

NSStepper.h

---