UIProgressView Class Reference

Inherits from
Conforms to
Framework
/System/Library/Frameworks/UIKit.framework
Availability
Available in iOS 2.0 and later.
Companion guide
Declared in
UIProgressView.h
Related sample code

Overview

You use the UIProgressView class to depict the progress of a task over time. An example of a progress bar is the one shown at the bottom of the Mail application when it’s downloading messages.

The UIProgressView class provides properties for managing the style of the progress bar and for getting and setting values that are pinned to the progress of a task.

For an indeterminate progress indicator—or, informally, a “spinner”—use an instance of the UIActivityIndicatorView class.

For more information about appearance and behavior configuration, see “Progress Views”.

Tasks

Initializing the UIProgressView Object

Managing the Progress Bar

Configuring the Progress Bar

Properties

progress

The current progress shown by the receiver.

@property(nonatomic) float progress
Discussion

The current progress is represented by a floating-point value between 0.0 and 1.0, inclusive, where 1.0 indicates the completion of the task. The default value is 0.0. Values less than 0.0 and greater than 1.0 are pinned to those limits.

Availability
  • Available in iOS 2.0 and later.
Declared In
UIProgressView.h

progressImage

An image to use for the portion of the progress bar that is filled.

@property(nonatomic, retain) UIImage *progressImage
Discussion

If you provide a custom image, the progressTintColor property is ignored.

Availability
  • Available in iOS 5.0 and later.
Declared In
UIProgressView.h

progressTintColor

The color shown for the portion of the progress bar that is filled.

@property(nonatomic, retain) UIColor *progressTintColor
Availability
  • Available in iOS 5.0 and later.
Declared In
UIProgressView.h

progressViewStyle

The current graphical style of the receiver.

@property(nonatomic) UIProgressViewStyle progressViewStyle
Discussion

The value of this property is a constant that specifies the style of the progress view. The default style is UIProgressViewStyleDefault. For more on these constants, see UIProgressViewStyle.

Availability
  • Available in iOS 2.0 and later.
Declared In
UIProgressView.h

trackImage

An image to use for the portion of the track that is not filled.

@property(nonatomic, retain) UIImage *trackImage
Discussion

If you provide a custom image, the trackTintColor property is ignored.

Availability
  • Available in iOS 5.0 and later.
Declared In
UIProgressView.h

trackTintColor

The color shown for the portion of the progress bar that is not filled.

@property(nonatomic, retain) UIColor *trackTintColor
Availability
  • Available in iOS 5.0 and later.
Declared In
UIProgressView.h

Instance Methods

initWithProgressViewStyle:

Initializes and returns an progress-view object.

- (id)initWithProgressViewStyle:(UIProgressViewStyle)style
Parameters
style

A constant that specifies the style of the object to be created. See UIProgressViewStyle for descriptions of the style constants.

Return Value

An initialized UIProgressView object or nil if the object couldn’t be created.

Discussion

UIProgressView sets the height of the returned view according to the specified style. You can set and retrieve the style of a progress view through the progressViewStyle property.

Availability
  • Available in iOS 2.0 and later.
Related Sample Code
Declared In
UIProgressView.h

setProgress:animated:

Adjusts the current progress shown by the receiver, optionally animating the change.

- (void)setProgress:(float)progress animated:(BOOL)animated
Parameters
progress

The new progress value.

animated

YES if the change should be animated, NO if the change should happen immediately.

Discussion

The current progress is represented by a floating-point value between 0.0 and 1.0, inclusive, where 1.0 indicates the completion of the task. The default value is 0.0. Values less than 0.0 and greater than 1.0 are pinned to those limits.

Availability
  • Available in iOS 5.0 and later.
Declared In
UIProgressView.h

Constants

UIProgressViewStyle

The styles permitted for the progress bar.

typedef enum {
   UIProgressViewStyleDefault,
   UIProgressViewStyleBar,
} UIProgressViewStyle;
Constants
UIProgressViewStyleDefault

The standard progress-view style. This is the default.

Available in iOS 2.0 and later.

Declared in UIProgressView.h.

UIProgressViewStyleBar

The style of progress view that is used in a toolbar.

Available in iOS 2.0 and later.

Declared in UIProgressView.h.

Discussion

You can set and retrieve the current style of progress view through the progressViewStyle property.

Availability
  • Available in iOS 2.0 and later.
Declared In
UIProgressView.h