Instance Method

characterIndexForInsertionAtPoint:

Returns a character index appropriate for placing a zero-length selection for an insertion point associated with the mouse at the given point.

Declaration

- (NSUInteger)characterIndexForInsertionAtPoint:(NSPoint)point;

Parameters

point

The point for which to return an index, in view coordinates.

Return Value

The character index for the insertion point.

Discussion

This method should be used for insertion points associated with mouse clicks, drag events, and so forth. For other purposes, it is better to use NSLayoutManager methods.

The NSTextInput method characterIndexForPoint: is not suitable for this role; it is intended only for uses related to text input methods.

See Also

Managing the Selection

selectedRanges

An array containing the ranges of characters selected in the receiver’s layout manager.

- setSelectedRange:

Sets the selection to the characters in an array of ranges.

- setSelectedRange:affinity:stillSelecting:

Sets the selection to a range of characters in response to user action.

- setSelectedRanges:affinity:stillSelecting:

Sets the selection to the characters in an array of ranges in response to user action.

selectionAffinity

The preferred direction of selection.

selectionGranularity

The selection granularity for subsequent extension of a selection.

insertionPointColor

The color of the insertion point.

- updateInsertionPointStateAndRestartTimer:

Updates the insertion point’s location and optionally restarts the blinking cursor timer.

selectedTextAttributes

The attributes used to indicate the selection.

markedTextAttributes

The attributes used to draw marked text.

linkTextAttributes

The attributes used to draw the onscreen presentation of link text.