Class

NSProgressIndicator

An interface that provides visual feedback to the user about the status of an ongoing task.

Declaration

@interface NSProgressIndicator : NSView

Overview

Progress indicators can be determinate or indeterminate. A determinate indicator displays the completion percentage of a task. An indeterminate indicator shows that the app is busy without providing a visual indication of how long the task will take.

Topics

Animating the progress indicator

- startAnimation:

Starts the animation of an indeterminate progress indicator.

- stopAnimation:

Stops the animation of an indeterminate progress indicator.

usesThreadedAnimation

A Boolean that indicates whether the progress indicator implements animation in a separate thread.

- animate:

This action method advances the progress animation of an indeterminate progress animator by one step.

Deprecated
- animationDelay

Returns the delay, in seconds, between animation steps for an indeterminate progress indicator.

Deprecated
- setAnimationDelay:

Sets the delay, in seconds, between animation steps for an indeterminate progress indicator.

Deprecated

Advancing the progress bar

- incrementBy:

Advances the progress bar of a determinate progress indicator by the specified amount.

doubleValue

The value that indicates the current extent of the progress indicator.

minValue

The minimum value for the progress indicator.

maxValue

The maximum value for the progress indicator.

Setting the appearance

controlSize

The size of the progress indicator.

controlTint

The progress indicator’s control tint.

bezeled

A Boolean that indicates whether the progress indicator’s frame has a three-dimensional bezel.

indeterminate

A Boolean that indicates whether the progress indicator is indeterminate.

style

The style of the progress indicator (bar or spinning).

- sizeToFit

This action method resizes the progress indicator to an appropriate size depending on the value of style.

displayedWhenStopped

A Boolean that indicates whether the progress indicator hides itself when it isn’t animating.

Constants

NSProgressIndicatorThickness

Specify the height of a progress indicator.

Deprecated
NSProgressIndicatorStyle

Specify the progress indicator’s style used by style.

Relationships

Inherits From

See Also

Controls

NSButton

A control that defines an area on the screen that can be used to trigger actions.

NSColorWell

A control that displays a color value and lets the user change that color value.

Date Picker

Display a calendar date and provide controls for editing the date value.

NSImageView

A display of image data from an NSImage object in a frame.

NSLevelIndicator

A visual representation of a level or quantity, using discrete values.

Path Control

A display of a file system path or virtual path information.

NSPopUpButton

A display of a single item from a list of items, and provide an interface for selecting items from the list.

NSRuleEditor

An interface for configuring a rule-based list of options.

NSPredicateEditor

A defined set of rules that allows the editing of predicate objects.

Search Field

Provide a text field that is optimized for text-based search interfaces.

NSSegmentedControl

Display one or more buttons in a single horizontal group.

Slider

Display a range of values from which the user selects a single value.

NSStepper

An interface with up and down arrow buttons for incrementing or decrementing a value.

Text Field

Provide a simple interface for displaying and editing text, including support for password fields and secure forms of text entry.

Token Field

Provide a text field whose text can be rendered in a visually distinct way so that users can recognize portions more easily.

Toolbar

Provide a space for controls under a window's title bar and above your custom content.

Combo Box

Display a list of values in a pop-up menu that lets the user select a value or type in a custom value.

NSMatrix

A legacy interface for grouping radio buttons or other types of cells together.