---
title: NSLevelIndicator
framework: appkit
role: symbol
role_heading: Class
path: appkit/nslevelindicator
---

# NSLevelIndicator

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

## Declaration

```swift
class NSLevelIndicator
```

## Overview

Overview A level indicator is similar to an NSSlider object, but provides a more customized visual feedback to the user. Unlike sliders, level indicators do not have a “knob” indicating the current setting, and they do not allow the user to adjust the current setting. You set the value of the level indicator programmatically. The supported indicator styles include: A capacity style level indicator. The continuous mode for this style is often used to indicate conditions such as how much data is on hard disk. The discrete mode is similar to audio level indicators in audio playback applications. You can specify both a warning value and a critical value that provides additional visual feedback to the user. A ranking style level indicator. This is similar to the star ranking displays provided in iTunes and iPhoto. You can also specify your own ranking image. A relevancy style level indicator. This style is used to display the relevancy of a search result, for example in Mail. NSLevelIndicator uses an NSLevelIndicatorCell to implement much of the control’s functionality. NSLevelIndicator provides cover methods for most of the NSLevelIndicatorCell methods, which call the corresponding cell method.

## Topics

### Configuring the Cell

- [NSLevelIndicatorCell](appkit/nslevelindicatorcell.md)

### Configuring the Range of Values

- [minValue](appkit/nslevelindicator/minvalue.md)
- [maxValue](appkit/nslevelindicator/maxvalue.md)
- [warningValue](appkit/nslevelindicator/warningvalue.md)
- [criticalValue](appkit/nslevelindicator/criticalvalue.md)

### Managing Tick Marks and Style

- [tickMarkPosition](appkit/nslevelindicator/tickmarkposition.md)
- [numberOfTickMarks](appkit/nslevelindicator/numberoftickmarks.md)
- [numberOfMajorTickMarks](appkit/nslevelindicator/numberofmajortickmarks.md)
- [tickMarkValue(at:)](appkit/nslevelindicator/tickmarkvalue(at:).md)
- [rectOfTickMark(at:)](appkit/nslevelindicator/rectoftickmark(at:).md)
- [levelIndicatorStyle](appkit/nslevelindicator/levelindicatorstyle.md)
- [NSLevelIndicator.Style](appkit/nslevelindicator/style.md)

### Configuring the Drawing Attributes

- [ratingImage](appkit/nslevelindicator/ratingimage.md)
- [drawsTieredCapacityLevels](appkit/nslevelindicator/drawstieredcapacitylevels.md)
- [fillColor](appkit/nslevelindicator/fillcolor.md)
- [warningFillColor](appkit/nslevelindicator/warningfillcolor.md)
- [criticalFillColor](appkit/nslevelindicator/criticalfillcolor.md)

### Managing Placeholder Information

- [ratingPlaceholderImage](appkit/nslevelindicator/ratingplaceholderimage.md)
- [placeholderVisibility](appkit/nslevelindicator/placeholdervisibility-swift.property.md)
- [NSLevelIndicator.PlaceholderVisibility](appkit/nslevelindicator/placeholdervisibility-swift.enum.md)

### Controlling the Edit Behavior

- [isEditable](appkit/nslevelindicator/iseditable.md)

## Relationships

### Inherits From

- [NSControl](appkit/nscontrol.md)

### Conforms To

- [CVarArg](swift/cvararg.md)
- [CustomDebugStringConvertible](swift/customdebugstringconvertible.md)
- [CustomStringConvertible](swift/customstringconvertible.md)
- [Equatable](swift/equatable.md)
- [Hashable](swift/hashable.md)
- [NSAccessibilityElementProtocol](appkit/nsaccessibilityelementprotocol.md)
- [NSAccessibilityProtocol](appkit/nsaccessibilityprotocol.md)
- [NSAnimatablePropertyContainer](appkit/nsanimatablepropertycontainer.md)
- [NSAppearanceCustomization](appkit/nsappearancecustomization.md)
- [NSCoding](foundation/nscoding.md)
- [NSDraggingDestination](appkit/nsdraggingdestination.md)
- [NSObjectProtocol](objectivec/nsobjectprotocol.md)
- [NSStandardKeyBindingResponding](appkit/nsstandardkeybindingresponding.md)
- [NSTouchBarProvider](appkit/nstouchbarprovider.md)
- [NSUserActivityRestoring](appkit/nsuseractivityrestoring.md)
- [NSUserInterfaceItemIdentification](appkit/nsuserinterfaceitemidentification.md)
- [Sendable](swift/sendable.md)
- [SendableMetatype](swift/sendablemetatype.md)

## See Also

### Controls

- [Responding to control-based events using target-action](uikit/responding-to-control-based-events-using-target-action.md)
- [NSButton](appkit/nsbutton.md)
- [NSColorWell](appkit/nscolorwell.md)
- [Combo Box](appkit/combo-box.md)
- [NSComboButton](appkit/nscombobutton.md)
- [Date Picker](appkit/date-picker.md)
- [NSImageView](appkit/nsimageview.md)
- [Path Control](appkit/path-control.md)
- [NSPopUpButton](appkit/nspopupbutton.md)
- [NSProgressIndicator](appkit/nsprogressindicator.md)
- [NSRuleEditor](appkit/nsruleeditor.md)
- [NSPredicateEditor](appkit/nspredicateeditor.md)
- [Search Field](appkit/search-field.md)
- [NSSegmentedControl](appkit/nssegmentedcontrol.md)
- [Slider](appkit/slider.md)