UIKit User Interface Catalog: Label

Text and Behavior

image: ../Art/uilabel_attributes_inspector_group-text_layout_behavior.pdf

Lines

The maximum number of lines for the label text.

Set to 0 for an unlimited number of lines.

Access: numberOfLines.

Text

Text Type

The type of the label text.


Selection
Plain
Attributed

Text Type: Plain

This group configures the label plain text.

Text

The label plain text.

Access: text.

Color

The color of the label plain text.

Access: textColor.

Font

The font of the label plain text.

Access: font.

Alignment

The alignment of the label plain text.


Selection	Method	Argument
Left	`textAlignment`	`NSTextAlignmentLeft`
Center	`textAlignment`	`NSTextAlignmentCenter`
Right	`textAlignment`	`NSTextAlignmentRight`

Text Type: Attributed

This group configures the text selected in Attributed Text.

image: ../Art/uilabel_attributes_inspector_subgroup-text-attributed.pdf

Attributed Text Layout

The alignment and other layout characteristics of the selected attributed text.

To set alignment and other layout characteristics of part of the attributed text in code, you need to create an attributed string with the desired characteristics and assign it to attributedText.


Selection
Left
Center
Right
Justified
Natural
Text Color
Background Color
More

Font

The font of the selected attributed text.

Access: font.

Attributed Text

The label attributed text.

Access: attributedText.

Behavior

Enabled

Whether the label is enabled.


Selection	Method	Argument
Unselected	`enabled`	`NO`
Selected	`enabled`	`YES`

Highlighted

Whether the label is highlighted.

Toggle this property after setting the text highlight color to preview the highlighted label.


Selection	Method	Argument
Unselected	`highlighted`	`NO`
Selected	`highlighted`	`YES`

Text Baseline and Line Breaks

Baseline

How to adjust the text baseline so that the text fits in the label.


Selection	Method	Argument
Align Baselines	`baselineAdjustment`	`UIBaselineAdjustmentAlignBaselines`
Align Centers	`baselineAdjustment`	`UIBaselineAdjustmentAlignCenters`
None	`baselineAdjustment`	`UIBaselineAdjustmentNone`

Line Breaks

The line break mode of the label text.


Selection	Method	Argument
Clip	`lineBreakMode`	`UILineBreakModeClip`
Character Wrap	`lineBreakMode`	`UILineBreakModeCharacterWrap`
Word Wrap	`lineBreakMode`	`UILineBreakModeWordWrap`
Truncate Head	`lineBreakMode`	`UILineBreakModeHeadTruncation`
Truncate Middle	`lineBreakMode`	`UILineBreakModeMiddleTruncation`
Truncate Tail	`lineBreakMode`	`UILineBreakModeTailTruncation`

Text Sizing

Autoshrink

How to shrink the label text so that it fits in the label.


Selection	Method	Argument	Method
Fixed Font Size	`adjustsFontSizeToFitWidth`	`NO`
Minimum Font Scale	`adjustsFontSizeToFitWidth`	`YES`	`minimumScaleFactor`
Minimum Font Size	`adjustsFontSizeToFitWidth`	`YES`	`minimumFontSize`

Tighten Letter Spacing

Whether to reduce the label text letter spacing so that it fits in the label.


Selection	Method	Argument
Unselected	`adjustsLetterSpacingToFitWidth`	`NO`
Selected	`adjustsLetterSpacingToFitWidth`	`YES`

Text Highlight and Shadow

image: ../Art/uilabel_attributes_inspector_group-texthighlight_shadow.pdf

Highlighted

The color for the label text when the label is highlighted.

This property applies only to plain text labels.

Access: highlightedTextColor.

Shadow

The color of the label text shadow.

Access: shadowColor.

Shadow Offset

The offset of the label text shadow.

Access: shadowOffset.

Label

Label Attributes Inspector Reference