tintAdjustmentMode

Tint adjustment mode is a property of UIView in iOS that indicates whether the view’s tint color should be dimmed. It helps manage the visual treatment of tinted controls when an interface element is in a inactive or overlay state. The two possible values are automatic and dimmed. In practice, when a view’s tintAdjustmentMode is dimmed, controls that rely on the view’s tintColor render with a subdued tint; when set to automatic, UIKit selects dimmed or normal based on the current UI state.

The system commonly uses tint adjustment to convey focus or disabled state. For example, presenting a modal view or an overlay can cause underlying content to enter a dimmed tint mode, signaling that it is not the next target of user interaction. This behavior applies to many controls that draw themselves using the tintColor, such as buttons, switches, and other controls that honor tint.

Programming usage is straightforward. In Swift, you can force dimming with:

view.tintAdjustmentMode = .dimmed

and return to normal with:

view.tintAdjustmentMode = .automatic

In Objective-C, you would use the corresponding enum values (such as UIViewTintAdjustmentModeDimmed).

Notes:

- Tint adjustment affects only views and controls that utilize the tintColor; not all UI elements respond identically.

- Some views respond to changes by overriding tintColorDidChange to update their appearance.

- The property can be inspected via view.tintAdjustmentMode to determine whether a view is currently dimmed.

Related concepts include the tintColor property itself and the broader use of dynamic tint in adaptive interfaces.