AppKit macOS 12.3 to 13.0 API Differences

NSColorWell.h
Added NSColorWellStyle
Added NSColorWellStyleDefault
Added NSColorWellStyleMinimal
Added NSColorWellStyleExpanded
Added +[NSColorWell colorWellWithStyle:]
Added NSColorWell.colorWellStyle
Added NSColorWell.image
Added NSColorWell.pulldownTarget
Added NSColorWell.pulldownAction
Modified NSColorWell.bordered
AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedThis property will be deprecated in a future release.

NSComboButton.h
Added NSComboButtonStyle
Added NSComboButtonStyleSplit
Added NSComboButtonStyleUnified
Added NSComboButton
Added +[NSComboButton comboButtonWithTitle:menu:target:action:]
Added +[NSComboButton comboButtonWithImage:menu:target:action:]
Added +[NSComboButton comboButtonWithTitle:image:menu:target:action:]
Added NSComboButton.title
Added NSComboButton.image
Added NSComboButton.imageScaling
Added NSComboButton.menu
Added NSComboButton.style
NSImage.h
Added +[NSImage imageWithSymbolName:variableValue:]
Added +[NSImage imageWithSystemSymbolName:variableValue:accessibilityDescription:]
Modified NSImage
Protocols
FromNSCopying, NSPasteboardReading, NSPasteboardWriting, NSSecureCoding
ToNSCopying, NSItemProviderReading, NSItemProviderWriting, NSPasteboardReading, NSPasteboardWriting, NSSecureCoding

Modified -[NSImage lockFocus]
AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedThis method is incompatible with resolution-independent drawing and should not be used. Instead, use +[NSImage imageWithSize:flipped:drawingHandler:] to create a block-based image describing the desired image drawing, or use +[NSGraphicsContext graphicsContextWithBitmapImageRep:] to manipulate specific bitmap image representations.

Modified -[NSImage lockFocusFlipped:]
AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedThis method is incompatible with resolution-independent drawing and should not be used. Instead, use +[NSImage imageWithSize:flipped:drawingHandler:] to create a block-based image describing the desired image drawing, or use +[NSGraphicsContext graphicsContextWithBitmapImageRep:] to manipulate specific bitmap image representations.

Modified -[NSImage unlockFocus]
AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedThis method is incompatible with resolution-independent drawing and should not be used. Instead, use +[NSImage imageWithSize:flipped:drawingHandler:] to create a block-based image describing the desired image drawing, or use +[NSGraphicsContext graphicsContextWithBitmapImageRep:] to manipulate specific bitmap image representations.

NSPreviewRepresentingActivityItem.h
Added NSPreviewRepresentableActivityItem
Added NSPreviewRepresentableActivityItem.item
Added NSPreviewRepresentableActivityItem.title
Added NSPreviewRepresentableActivityItem.imageProvider
Added NSPreviewRepresentableActivityItem.iconProvider
Added NSPreviewRepresentingActivityItem
Added -[NSPreviewRepresentingActivityItem initWithItem:title:image:icon:]
Added -[NSPreviewRepresentingActivityItem initWithItem:title:imageProvider:iconProvider:]
NSSharingService.h
Added NSSharingServicePicker.standardShareMenuItem
Modified +[NSSharingService sharingServicesForItems:]
AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedUse -[NSSharingServicePicker standardShareMenuItem] instead.

NSTextElement.h
Added NSTextElement.childElements
Added NSTextElement.parentElement
Added NSTextElement.isRepresentedElement
NSTextList.h
Added -[NSTextList initWithMarkerFormat:options:startingItemNumber:]
Added -[NSTextList initWithCoder:]
Added NSTextList.ordered
Modified NSTextListMarkerBox
Declaration
FromAPI_AVAILABLE(macos(10.13)) const NSTextListMarkerFormat NSTextListMarkerBox
ToAPI_UNAVAILABLE(watchos) const NSTextListMarkerFormat NSTextListMarkerBox

Modified NSTextListMarkerCheck
Declaration
FromAPI_AVAILABLE(macos(10.13)) const NSTextListMarkerFormat NSTextListMarkerCheck
ToAPI_UNAVAILABLE(watchos) const NSTextListMarkerFormat NSTextListMarkerCheck

Modified NSTextListMarkerCircle
Declaration
FromAPI_AVAILABLE(macos(10.13)) const NSTextListMarkerFormat NSTextListMarkerCircle
ToAPI_UNAVAILABLE(watchos) const NSTextListMarkerFormat NSTextListMarkerCircle

Modified NSTextListMarkerDiamond
Declaration
FromAPI_AVAILABLE(macos(10.13)) const NSTextListMarkerFormat NSTextListMarkerDiamond
ToAPI_UNAVAILABLE(watchos) const NSTextListMarkerFormat NSTextListMarkerDiamond

Modified NSTextListMarkerDisc
Declaration
FromAPI_AVAILABLE(macos(10.13)) const NSTextListMarkerFormat NSTextListMarkerDisc
ToAPI_UNAVAILABLE(watchos) const NSTextListMarkerFormat NSTextListMarkerDisc

Modified NSTextListMarkerHyphen
Declaration
FromAPI_AVAILABLE(macos(10.13)) const NSTextListMarkerFormat NSTextListMarkerHyphen
ToAPI_UNAVAILABLE(watchos) const NSTextListMarkerFormat NSTextListMarkerHyphen

Modified NSTextListMarkerSquare
Declaration
FromAPI_AVAILABLE(macos(10.13)) const NSTextListMarkerFormat NSTextListMarkerSquare
ToAPI_UNAVAILABLE(watchos) const NSTextListMarkerFormat NSTextListMarkerSquare

Modified NSTextListMarkerLowercaseHexadecimal
Declaration
FromAPI_AVAILABLE(macos(10.13)) const NSTextListMarkerFormat NSTextListMarkerLowercaseHexadecimal
ToAPI_UNAVAILABLE(watchos) const NSTextListMarkerFormat NSTextListMarkerLowercaseHexadecimal

Modified NSTextListMarkerUppercaseHexadecimal
Declaration
FromAPI_AVAILABLE(macos(10.13)) const NSTextListMarkerFormat NSTextListMarkerUppercaseHexadecimal
ToAPI_UNAVAILABLE(watchos) const NSTextListMarkerFormat NSTextListMarkerUppercaseHexadecimal

Modified NSTextListMarkerOctal
Declaration
FromAPI_AVAILABLE(macos(10.13)) const NSTextListMarkerFormat NSTextListMarkerOctal
ToAPI_UNAVAILABLE(watchos) const NSTextListMarkerFormat NSTextListMarkerOctal

Modified NSTextListMarkerLowercaseAlpha
Declaration
FromAPI_AVAILABLE(macos(10.13)) const NSTextListMarkerFormat NSTextListMarkerLowercaseAlpha
ToAPI_UNAVAILABLE(watchos) const NSTextListMarkerFormat NSTextListMarkerLowercaseAlpha

Modified NSTextListMarkerUppercaseAlpha
Declaration
FromAPI_AVAILABLE(macos(10.13)) const NSTextListMarkerFormat NSTextListMarkerUppercaseAlpha
ToAPI_UNAVAILABLE(watchos) const NSTextListMarkerFormat NSTextListMarkerUppercaseAlpha

Modified NSTextListMarkerLowercaseLatin
Declaration
FromAPI_AVAILABLE(macos(10.13)) const NSTextListMarkerFormat NSTextListMarkerLowercaseLatin
ToAPI_UNAVAILABLE(watchos) const NSTextListMarkerFormat NSTextListMarkerLowercaseLatin

Modified NSTextListMarkerUppercaseLatin
Declaration
FromAPI_AVAILABLE(macos(10.13)) const NSTextListMarkerFormat NSTextListMarkerUppercaseLatin
ToAPI_UNAVAILABLE(watchos) const NSTextListMarkerFormat NSTextListMarkerUppercaseLatin

Modified NSTextListMarkerLowercaseRoman
Declaration
FromAPI_AVAILABLE(macos(10.13)) const NSTextListMarkerFormat NSTextListMarkerLowercaseRoman
ToAPI_UNAVAILABLE(watchos) const NSTextListMarkerFormat NSTextListMarkerLowercaseRoman

Modified NSTextListMarkerUppercaseRoman
Declaration
FromAPI_AVAILABLE(macos(10.13)) const NSTextListMarkerFormat NSTextListMarkerUppercaseRoman
ToAPI_UNAVAILABLE(watchos) const NSTextListMarkerFormat NSTextListMarkerUppercaseRoman

Modified NSTextListMarkerDecimal
Declaration
FromAPI_AVAILABLE(macos(10.13)) const NSTextListMarkerFormat NSTextListMarkerDecimal
ToAPI_UNAVAILABLE(watchos) const NSTextListMarkerFormat NSTextListMarkerDecimal

Modified NSTextList.markerFormat
Declaration
From@property (readonly, copy, nonnull) NSTextListMarkerFormat markerFormat
To@property (readonly, strong, nonnull) NSTextListMarkerFormat markerFormat

NSTextListElement.h
Added NSTextListElement
Added -[NSTextListElement initWithParentElement:textList:contents:markerAttributes:childElements:]
Added +[NSTextListElement textListElementWithContents:markerAttributes:textList:childElements:]
Added +[NSTextListElement textListElementWithChildElements:textList:nestingLevel:]
Added NSTextListElement.textList
Added NSTextListElement.contents
Added NSTextListElement.markerAttributes
Added NSTextListElement.attributedString
Added NSTextListElement.childElements
Added NSTextListElement.parentElement
NSTextView.h
Modified NSTextViewWillSwitchToNSLayoutManagerNotification
Declaration
FromNSNotificationName _Nonnull NSTextViewWillSwitchToNSLayoutManagerNotification
ToAPI_AVAILABLE(macos(12.0)) NSNotificationName NSTextViewWillSwitchToNSLayoutManagerNotification

Modified NSTextViewDidSwitchToNSLayoutManagerNotification
Declaration
FromNSNotificationName _Nonnull NSTextViewDidSwitchToNSLayoutManagerNotification
ToAPI_AVAILABLE(macos(12.0)) NSNotificationName NSTextViewDidSwitchToNSLayoutManagerNotification

NSToolbar.h
Added NSToolbarUserInfoKey
Added NSToolbarItemKey
Added NSToolbar.centeredItemIdentifiers
Added -[NSToolbarDelegate toolbarImmovableItemIdentifiers:]
Added -[NSToolbarDelegate toolbar:itemIdentifier:canBeInsertedAtIndex:]
Modified NSToolbarSizeModeDefault
AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedNSToolbarSizeMode is no longer recommended and will be ignored in the future

Modified NSToolbarSizeModeRegular
AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedNSToolbarSizeMode is no longer recommended and will be ignored in the future

Modified NSToolbarSizeModeSmall
AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedNSToolbarSizeMode is no longer recommended and will be ignored in the future

Modified NSToolbar.sizeMode
AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedNSToolbarSizeMode is no longer recommended and will be ignored in the future

Modified NSToolbar.centeredItemIdentifier
DeclarationAvailabilityDeprecation Message
From@property (copy, nullable) NSToolbarItemIdentifier centeredItemIdentifierAvailablenone
To@property (copy, nullable) NSToolbarItemIdentifier centeredItemIdentifierDeprecatedUse the centeredItemIdentifiers property instead

NSToolbarItem.h
Added NSToolbarItem.possibleLabels
Added NSToolbarItem.visible
NSWindow.h
Modified NSWindow.showsToolbarButton
AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedThis property has no effect