apple.uikit

Class NSTextContentManager

java.lang.Object

org.moe.natj.general.NativeObject

org.moe.natj.objc.ObjCObject

apple.NSObject

apple.uikit.NSTextContentManager

All Implemented Interfaces:

NSCoding, NSSecureCoding, NSObject, NSTextElementProvider

Direct Known Subclasses:

NSTextContentStorage

public class NSTextContentManager
extends NSObject
implements NSTextElementProvider, NSSecureCoding

NSTextContentManager is an abstract class defining the interface for managing the text document contents and the default implementation. The concrete subclass overrides NSTextElementProvider for managing the content backing store. It is the root object strongly referencing the rest of objects in the TextKit network via an array of NSTextLayoutManager. Also, it manages the editing transaction by tracking the active NSTextLayoutManager focused to be editing.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	NSTextContentManager.Block_performEditingTransactionUsingBlock
static interface	NSTextContentManager.Block_synchronizeTextLayoutManagers

Nested classes/interfaces inherited from class apple.NSObject

NSObject.Function_instanceMethodForSelector_ret, NSObject.Function_methodForSelector_ret

Nested classes/interfaces inherited from interface apple.uikit.protocol.NSTextElementProvider

NSTextElementProvider.Block_enumerateTextElementsFromLocationOptionsUsingBlock, NSTextElementProvider.Block_synchronizeToBackingStore

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	NSTextContentManager(org.moe.natj.general.Pointer peer)

Method Summary

Modifier and Type	Method and Description
boolean	_supportsSecureCoding() This property must return YES on all classes that allow secure coding.
static boolean	accessInstanceVariablesDirectly()
void	addTextLayoutManager(NSTextLayoutManager textLayoutManager)
NSTextRange	adjustedRangeFromRangeForEditingTextSelection(NSTextRange textRange, boolean forEditingTextSelection) Should be implemented if the location backing store requires manual adjustment after editing.
static NSTextContentManager	alloc()
static NSTextContentManager	allocWithZone(org.moe.natj.general.ptr.VoidPtr zone)
static boolean	automaticallyNotifiesObserversForKey(java.lang.String key)
boolean	automaticallySynchronizesTextLayoutManagers() Automatically synchronizes all text layout managers when hasEditingTransaction becoming NO.
boolean	automaticallySynchronizesToBackingStore() Automatically synchronizes the backing store when hasEditingTransaction becoming NO.
static void	cancelPreviousPerformRequestsWithTarget(java.lang.Object aTarget)
static void	cancelPreviousPerformRequestsWithTargetSelectorObject(java.lang.Object aTarget, org.moe.natj.objc.SEL aSelector, java.lang.Object anArgument)
static NSArray<java.lang.String>	classFallbacksForKeyedArchiver()
static org.moe.natj.objc.Class	classForKeyedUnarchiver()
static java.lang.String	debugDescription_static()
java.lang.Object	delegate()
static java.lang.String	description_static()
NSTextRange	documentRange() Declares the starting and ending locations for the document.
void	encodeWithCoder(NSCoder coder)
NSTextLocation	enumerateTextElementsFromLocationOptionsUsingBlock(NSTextLocation textLocation, long options, NSTextElementProvider.Block_enumerateTextElementsFromLocationOptionsUsingBlock block) Enumerates the text elements starting at textLocation.
boolean	hasEditingTransaction() When YES, there is an active editing transaction from primaryTextLayoutManager.
static long	hash_static()
NSTextContentManager	init()
NSTextContentManager	initWithCoder(NSCoder coder) NS_DESIGNATED_INITIALIZER
static NSObject.Function_instanceMethodForSelector_ret	instanceMethodForSelector(org.moe.natj.objc.SEL aSelector)
static NSMethodSignature	instanceMethodSignatureForSelector(org.moe.natj.objc.SEL aSelector)
static boolean	instancesRespondToSelector(org.moe.natj.objc.SEL aSelector)
static boolean	isSubclassOfClass(org.moe.natj.objc.Class aClass)
static NSSet<java.lang.String>	keyPathsForValuesAffectingValueForKey(java.lang.String key)
NSTextLocation	locationFromLocationWithOffset(NSTextLocation location, long offset) Returns a new location from location with offset.
static NSTextContentManager	new_objc()
long	offsetFromLocationToLocation(NSTextLocation from, NSTextLocation to) Returns the offset between from and to.
void	performEditingTransactionUsingBlock(NSTextContentManager.Block_performEditingTransactionUsingBlock transaction) Invoked by primaryTextLayoutManager controlling the active editing transaction.
NSTextLayoutManager	primaryTextLayoutManager() The primary NSTextLayoutManager interacting with the user allowing to edit.
void	recordEditActionInRangeNewTextRange(NSTextRange originalTextRange, NSTextRange newTextRange) Records information about an edit action to the transaction.
void	removeTextLayoutManager(NSTextLayoutManager textLayoutManager)
void	replaceContentsInRangeWithTextElements(NSTextRange range, NSArray<? extends NSTextElement> textElements) Replaces the characters specified by range with textElements.
static boolean	resolveClassMethod(org.moe.natj.objc.SEL sel)
static boolean	resolveInstanceMethod(org.moe.natj.objc.SEL sel)
void	setAutomaticallySynchronizesTextLayoutManagers(boolean value) Automatically synchronizes all text layout managers when hasEditingTransaction becoming NO.
void	setAutomaticallySynchronizesToBackingStore(boolean value) Automatically synchronizes the backing store when hasEditingTransaction becoming NO.
void	setDelegate_unsafe(java.lang.Object value)
void	setDelegate(java.lang.Object value)
void	setPrimaryTextLayoutManager(NSTextLayoutManager value) The primary NSTextLayoutManager interacting with the user allowing to edit.
static void	setVersion_static(long aVersion)
static org.moe.natj.objc.Class	superclass_static()
static boolean	supportsSecureCoding()
void	synchronizeTextLayoutManagers(NSTextContentManager.Block_synchronizeTextLayoutManagers completionHandler) Synchronizes changes to all non-primary text layout managers.
void	synchronizeToBackingStore(NSTextElementProvider.Block_synchronizeToBackingStore completionHandler) Synchronizes changes to the backing store.
NSArray<? extends NSTextElement>	textElementsForRange(NSTextRange range) Returns an array of NSTextElement intersecting the specified range in sequence.
NSArray<? extends NSTextLayoutManager>	textLayoutManagers() An array of NSTextLayoutManager.
static long	version_static()

Methods inherited from class apple.NSObject

accessibilityActivate, accessibilityActivationPoint, accessibilityAssistiveTechnologyFocusedIdentifiers, accessibilityAttributedHint, accessibilityAttributedLabel, accessibilityAttributedUserInputLabels, accessibilityAttributedValue, accessibilityContainerType, accessibilityCustomActions, accessibilityCustomRotors, accessibilityDecrement, accessibilityDragSourceDescriptors, accessibilityDropPointDescriptors, accessibilityElementAtIndex, accessibilityElementCount, accessibilityElementDidBecomeFocused, accessibilityElementDidLoseFocus, accessibilityElementIsFocused, accessibilityElements, accessibilityElementsHidden, accessibilityFrame, accessibilityHint, accessibilityIncrement, accessibilityLabel, accessibilityLanguage, accessibilityNavigationStyle, accessibilityPath, accessibilityPerformEscape, accessibilityPerformMagicTap, accessibilityRespondsToUserInteraction, accessibilityScroll, accessibilityTextualContext, accessibilityTraits, accessibilityUserInputLabels, accessibilityValue, accessibilityViewIsModal, addObserverForKeyPathOptionsContext, attemptRecoveryFromErrorOptionIndex, attemptRecoveryFromErrorOptionIndexDelegateDidRecoverSelectorContextInfo, autoContentAccessingProxy, awakeAfterUsingCoder, awakeFromNib, class_objc, classForCoder, classForKeyedArchiver, copy, dealloc, debugDescription, description, dictionaryWithValuesForKeys, didChangeValueForKey, didChangeValueForKeyWithSetMutationUsingObjects, didChangeValuesAtIndexesForKey, doesNotRecognizeSelector, fileManagerShouldProceedAfterError, fileManagerWillProcessPath, finalize_objc, forwardingTargetForSelector, forwardInvocation, hash, indexOfAccessibilityElement, isAccessibilityElement, isEqual, isKindOfClass, isMemberOfClass, isProxy, methodForSelector, methodSignatureForSelector, mutableArrayValueForKey, mutableArrayValueForKeyPath, mutableCopy, mutableOrderedSetValueForKey, mutableOrderedSetValueForKeyPath, mutableSetValueForKey, mutableSetValueForKeyPath, observationInfo, observeValueForKeyPathOfObjectChangeContext, performSelector, performSelectorInBackgroundWithObject, performSelectorOnMainThreadWithObjectWaitUntilDone, performSelectorOnMainThreadWithObjectWaitUntilDoneModes, performSelectorOnThreadWithObjectWaitUntilDone, performSelectorOnThreadWithObjectWaitUntilDoneModes, performSelectorWithObject, performSelectorWithObjectAfterDelay, performSelectorWithObjectAfterDelayInModes, performSelectorWithObjectWithObject, prepareForInterfaceBuilder, provideImageDataBytesPerRowOrigin_Size_UserInfo, removeObserverForKeyPath, removeObserverForKeyPathContext, replacementObjectForCoder, replacementObjectForKeyedArchiver, respondsToSelector, self, setAccessibilityActivationPoint, setAccessibilityAttributedHint, setAccessibilityAttributedLabel, setAccessibilityAttributedUserInputLabels, setAccessibilityAttributedValue, setAccessibilityContainerType, setAccessibilityCustomActions, setAccessibilityCustomRotors, setAccessibilityDragSourceDescriptors, setAccessibilityDropPointDescriptors, setAccessibilityElements, setAccessibilityElementsHidden, setAccessibilityFrame, setAccessibilityHint, setAccessibilityLabel, setAccessibilityLanguage, setAccessibilityNavigationStyle, setAccessibilityPath, setAccessibilityRespondsToUserInteraction, setAccessibilityTextualContext, setAccessibilityTraits, setAccessibilityUserInputLabels, setAccessibilityValue, setAccessibilityViewIsModal, setIsAccessibilityElement, setNilValueForKey, setObservationInfo, setShouldGroupAccessibilityChildren, setValueForKey, setValueForKeyPath, setValueForUndefinedKey, setValuesForKeysWithDictionary, shouldGroupAccessibilityChildren, superclass, validateValueForKeyError, validateValueForKeyPathError, valueForKey, valueForKeyPath, valueForUndefinedKey, willChangeValueForKey, willChangeValueForKeyWithSetMutationUsingObjects, willChangeValuesAtIndexesForKey

Methods inherited from class org.moe.natj.objc.ObjCObject

equals, toString

Methods inherited from class org.moe.natj.general.NativeObject

finalize, getPeer, getPeerPointer

Methods inherited from class java.lang.Object

clone, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

NSTextContentManager

protected NSTextContentManager(org.moe.natj.general.Pointer peer)

Method Detail

accessInstanceVariablesDirectly

public static boolean accessInstanceVariablesDirectly()

addTextLayoutManager

public void addTextLayoutManager(NSTextLayoutManager textLayoutManager)

adjustedRangeFromRangeForEditingTextSelection

public NSTextRange adjustedRangeFromRangeForEditingTextSelection(NSTextRange textRange,
                                                                 boolean forEditingTextSelection)

Description copied from interface: NSTextElementProvider

Should be implemented if the location backing store requires manual adjustment after editing. When textRange is intersecting or following the current edited range, the method returns the range adjusted for the modification in the editing session. Returns nil, when no adjustment necessary. forEditingTextSelection indicates if textRange is for the text selection associated with the edit session.

Specified by:

adjustedRangeFromRangeForEditingTextSelection in interface NSTextElementProvider

alloc

public static NSTextContentManager alloc()

allocWithZone

public static NSTextContentManager allocWithZone(org.moe.natj.general.ptr.VoidPtr zone)

automaticallyNotifiesObserversForKey

public static boolean automaticallyNotifiesObserversForKey(java.lang.String key)

automaticallySynchronizesTextLayoutManagers

public boolean automaticallySynchronizesTextLayoutManagers()

Automatically synchronizes all text layout managers when hasEditingTransaction becoming NO. YES by default.

automaticallySynchronizesToBackingStore

public boolean automaticallySynchronizesToBackingStore()

Automatically synchronizes the backing store when hasEditingTransaction becoming NO. NO by default.

cancelPreviousPerformRequestsWithTarget

public static void cancelPreviousPerformRequestsWithTarget(java.lang.Object aTarget)

cancelPreviousPerformRequestsWithTargetSelectorObject

public static void cancelPreviousPerformRequestsWithTargetSelectorObject(java.lang.Object aTarget,
                                                                         org.moe.natj.objc.SEL aSelector,
                                                                         java.lang.Object anArgument)

classFallbacksForKeyedArchiver

public static NSArray<java.lang.String> classFallbacksForKeyedArchiver()

classForKeyedUnarchiver

public static org.moe.natj.objc.Class classForKeyedUnarchiver()

debugDescription_static

public static java.lang.String debugDescription_static()

delegate

public java.lang.Object delegate()

description_static

public static java.lang.String description_static()

documentRange

public NSTextRange documentRange()

Description copied from interface: NSTextElementProvider

Declares the starting and ending locations for the document. The subclass could use its own implementation of a location object conforming to NSTextRange.

Specified by:

documentRange in interface NSTextElementProvider

encodeWithCoder

public void encodeWithCoder(NSCoder coder)

Specified by:

encodeWithCoder in interface NSCoding

enumerateTextElementsFromLocationOptionsUsingBlock

public NSTextLocation enumerateTextElementsFromLocationOptionsUsingBlock(NSTextLocation textLocation,
                                                                         long options,
                                                                         NSTextElementProvider.Block_enumerateTextElementsFromLocationOptionsUsingBlock block)

Description copied from interface: NSTextElementProvider

Enumerates the text elements starting at textLocation. If textLocation=nil, it assumes self.documentRange.location for forward enumeration; uses self.documentRange.endLocation for reverse enumeration. When enumerating backward, it starts with the element preceding the one containing textLocation. If enumerated at least one element, it returns the edge of the enumerated range. Note that the enumerated range might not match the range of the last element returned. It enumerates the elements in the sequence, but it can skip a range (it can limit the maximum number of text elements enumerated for a single invocation or hide some elements from the layout). Returning NO from block breaks out of the enumeration.

Specified by:

enumerateTextElementsFromLocationOptionsUsingBlock in interface NSTextElementProvider

hasEditingTransaction

public boolean hasEditingTransaction()

When YES, there is an active editing transaction from primaryTextLayoutManager. the synchronization operations to non-primary text layout managers and the backing store block (or fails when synchronous) while this property is YES. Non-primary text layout managers should avoid accessing the elements while this is YES. KVO-compliant

hash_static

public static long hash_static()

init

public NSTextContentManager init()

Overrides:

init in class NSObject

initWithCoder

public NSTextContentManager initWithCoder(NSCoder coder)

Description copied from interface: NSCoding

NS_DESIGNATED_INITIALIZER

Specified by:

initWithCoder in interface NSCoding

instanceMethodForSelector

public static NSObject.Function_instanceMethodForSelector_ret instanceMethodForSelector(org.moe.natj.objc.SEL aSelector)

instanceMethodSignatureForSelector

public static NSMethodSignature instanceMethodSignatureForSelector(org.moe.natj.objc.SEL aSelector)

instancesRespondToSelector

public static boolean instancesRespondToSelector(org.moe.natj.objc.SEL aSelector)

isSubclassOfClass

public static boolean isSubclassOfClass(org.moe.natj.objc.Class aClass)

keyPathsForValuesAffectingValueForKey

public static NSSet<java.lang.String> keyPathsForValuesAffectingValueForKey(java.lang.String key)

locationFromLocationWithOffset

public NSTextLocation locationFromLocationWithOffset(NSTextLocation location,
                                                     long offset)

Description copied from interface: NSTextElementProvider

Returns a new location from location with offset. The offset value could be positive or negative indicating the logical direction. Could return nil when the inputs don't produce any legal location (i.e. out of bounds index).

Specified by:

locationFromLocationWithOffset in interface NSTextElementProvider

new_objc

public static NSTextContentManager new_objc()

offsetFromLocationToLocation

public long offsetFromLocationToLocation(NSTextLocation from,
                                         NSTextLocation to)

Description copied from interface: NSTextElementProvider

Returns the offset between from and to. The return value could be positive or negative. Could return NSNotFound when the offset cannot be represented in an integer value (i.e. locations are not in the same document).

Specified by:

offsetFromLocationToLocation in interface NSTextElementProvider

performEditingTransactionUsingBlock

public void performEditingTransactionUsingBlock(NSTextContentManager.Block_performEditingTransactionUsingBlock transaction)

Invoked by primaryTextLayoutManager controlling the active editing transaction. Can be nested. The outer most transaction toggles hasEditingTransaction and sends synchronization messages if enabled after invoking transaction.

primaryTextLayoutManager

public NSTextLayoutManager primaryTextLayoutManager()

The primary NSTextLayoutManager interacting with the user allowing to edit. Setting an NSTextLayoutManager not in textLayoutManagers will reset to nil. It automatically synchronizes pending edits before switching to a new primary object. The operation is synchronous. KVO-compliant

recordEditActionInRangeNewTextRange

public void recordEditActionInRangeNewTextRange(NSTextRange originalTextRange,
                                                NSTextRange newTextRange)

Records information about an edit action to the transaction. originalTextRange is the range edited before the action, and newTextRange is the corresponding range after the action. The concrete subclass should invoke this method for each edit action.

removeTextLayoutManager

public void removeTextLayoutManager(NSTextLayoutManager textLayoutManager)

replaceContentsInRangeWithTextElements

public void replaceContentsInRangeWithTextElements(NSTextRange range,
                                                   NSArray<? extends NSTextElement> textElements)

Description copied from interface: NSTextElementProvider

Replaces the characters specified by range with textElements. If the edges of range is not at existing element range boundaries, it either split the element if it allows the operation (i.e. NSTextParagraph) or adjust the replacement range. This method is intended to be used only by NSTextLayoutManager.

Specified by:

replaceContentsInRangeWithTextElements in interface NSTextElementProvider

resolveClassMethod

public static boolean resolveClassMethod(org.moe.natj.objc.SEL sel)

resolveInstanceMethod

public static boolean resolveInstanceMethod(org.moe.natj.objc.SEL sel)

setAutomaticallySynchronizesTextLayoutManagers

public void setAutomaticallySynchronizesTextLayoutManagers(boolean value)

Automatically synchronizes all text layout managers when hasEditingTransaction becoming NO. YES by default.

setAutomaticallySynchronizesToBackingStore

public void setAutomaticallySynchronizesToBackingStore(boolean value)

Automatically synchronizes the backing store when hasEditingTransaction becoming NO. NO by default.

setDelegate_unsafe

public void setDelegate_unsafe(java.lang.Object value)

setDelegate

public void setDelegate(java.lang.Object value)

setPrimaryTextLayoutManager

public void setPrimaryTextLayoutManager(NSTextLayoutManager value)

The primary NSTextLayoutManager interacting with the user allowing to edit. Setting an NSTextLayoutManager not in textLayoutManagers will reset to nil. It automatically synchronizes pending edits before switching to a new primary object. The operation is synchronous. KVO-compliant

setVersion_static

public static void setVersion_static(long aVersion)

superclass_static

public static org.moe.natj.objc.Class superclass_static()

supportsSecureCoding

public static boolean supportsSecureCoding()

_supportsSecureCoding

public boolean _supportsSecureCoding()

Description copied from interface: NSSecureCoding

This property must return YES on all classes that allow secure coding. Subclasses of classes that adopt NSSecureCoding and override initWithCoder: must also override this method and return YES. The Secure Coding Guide should be consulted when writing methods that decode data.

Specified by:

_supportsSecureCoding in interface NSSecureCoding

synchronizeTextLayoutManagers

public void synchronizeTextLayoutManagers(NSTextContentManager.Block_synchronizeTextLayoutManagers completionHandler)

Synchronizes changes to all non-primary text layout managers. If completionHandler=nil, performs the operation synchronously. completionHandler gets passed error if failed. It should block (or fail if synchronous) when there is an active transaction.

synchronizeToBackingStore

public void synchronizeToBackingStore(NSTextElementProvider.Block_synchronizeToBackingStore completionHandler)

Description copied from interface: NSTextElementProvider

Synchronizes changes to the backing store. If completionHandler=nil, performs the operation synchronously. completionHandler gets passed error if failed. It should block (or fail if synchronous) when there is an active transaction.

Specified by:

synchronizeToBackingStore in interface NSTextElementProvider

textElementsForRange

public NSArray<? extends NSTextElement> textElementsForRange(NSTextRange range)

Returns an array of NSTextElement intersecting the specified range in sequence. It can return a set of elements not filling the entire range specified if the entire range is not synchronously available. Uses -enumerateTextElementsFromLocation:options:usingBlocK: to fill the array.

textLayoutManagers

public NSArray<? extends NSTextLayoutManager> textLayoutManagers()

An array of NSTextLayoutManager. KVO-compliant

version_static

public static long version_static()