An NSTextTab object represents a tab in an NSParagraphStyle object, storing an alignment type and location. NSTextTab objects are most frequently used with the TextKit system and with NSRulerView and NSRulerMarker objects.


The text system supports four alignment types: left, center, right, and decimal (based on the decimal separator character of the locale in effect). These alignment types are absolute, not based on the line sweep direction of text. For example, tabbed text is always positioned to the left of a right-aligned tab, whether the line sweep direction is left to right or right to left. A tab’s location, on the other hand, is relative to the back margin. A tab set at 1.5”, for example, is at 1.5” from the right in right to left text.


Creating a Text Tab

init(textAlignment: NSTextAlignment, location: CGFloat, options: [String : Any] = [:])

Initializes a text tab with the specified text alignment, location, and options.

Getting Tab Stop Information

var location: CGFloat

The receiver’s ruler location relative to the back margin.

Getting Text Tab Information

var alignment: NSTextAlignment

The text alignment of the receiver.

var options: [String : Any]

The dictionary of attributes associated with the receiver.

class func columnTerminators(for: Locale?)

Returns the column terminators for the given locale.


init(type: NSTextTabType, location: CGFloat)

Initializes a newly allocated text tab with the specified alignment and location.

var tabStopType: NSTextTabType

The receiver’s tab stop type.




These constants describe the various type of tab stop.

Terminating character

This constant specifies the terminating character for a tab column.