Instance Property

springLoaded

A Boolean value that indicates whether spring loading is enabled for the button.

Declaration

@property(getter=isSpringLoaded) BOOL springLoaded;

Discussion

The value of this property is YES if spring loading is enabled for the button, and NO if it is not. The default is NO.

On pressure-sensitive systems, such as systems with the Force Touch trackpad, spring loading is a feature that allows a user to activate a button by dragging selected items over it and force clicking—pressing harder—without dropping the selected items. The user can then continue dragging the items, possibly to perform additional actions.

A practical example of this feature can be found in the Calendar app. A selected calendar event can be dragged over the Calendars button in the toolbar. Force clicking on the button displays the calendar list without releasing the selected event. The event can then be dropped onto a calendar in the list, which assigns it to that calendar.

If spring loading is enabled on a button and a user drags items over it, the button highlights to indicate that it responds to force clicking. If the user presses harder, additional highlighting occurs to indicate that the button was fully activated.

On systems that don’t support pressure sensitivity, simply hovering over the button for a short period of time is sufficient to activate the button.

See Also

Configuring Buttons

- setButtonType:

Sets the button’s type, which affects its user interface and behavior when clicked.

- getPeriodicDelay:interval:

Returns by reference the delay and interval periods for a continuous button.

- setPeriodicDelay:interval:

Sets the message delay and interval periods for a continuous button.

alternateTitle

The title that the button displays when the button is in an on state.

attributedTitle

The title that the button displays in an off state, as an attributed string.

attributedAlternateTitle

The title that the button displays as an attributed string when the button is in an on state.

title

The title displayed on the button when it’s in an off state.

- setTitleWithMnemonic:

Sets the title of a button with a character denoting an access key.

Deprecated
sound

The sound that plays when the user clicks the button.

maxAcceleratorLevel

An integer value indicating the maximum pressure level for a button of type NSMultiLevelAcceleratorButton.