SetMarkedTextSelectionRangeReplacementRange Method (string, selectionRange, replacementRange)

Inserts the provided text and marks it to indicate that it is part of an active input session.

Original signature is '- (void)setMarkedText:(id)string selectionRange:(NSRange)selectionRange replacementRange:(NSRange)replacementRange'

Available in Mac OS X v10.5 and later.

Declaration Syntax

Visual Basic

Visual C++

void SetMarkedTextSelectionRangeReplacementRange(
	Id string,
	NSRange selectionRange,
	NSRange replacementRange
)

Sub SetMarkedTextSelectionRangeReplacementRange ( _
	string As Id, _
	selectionRange As NSRange, _
	replacementRange As NSRange _
)

void SetMarkedTextSelectionRangeReplacementRange(
	Id^ string, 
	NSRange selectionRange, 
	NSRange replacementRange
)

Parameters

string (Id): An NSString or an NSAttributedString object. Passing an NSString object produces default marking. On a 72 dpi screen the default marking is a 2 pixel black underline for the entire string.

selectionRange (NSRange): The selection range, which is relative to the string parameter. For example, if the string contains the these characters: "INPUT" and the range is (5,0), the selection is set immediately after the "T."

replacementRange (NSRange): A range that specifies the location in the client document where the marked text should be placed. If the marked text should be placed at the current cursor location replacementRange equals NSNotFound. If not NSNotFound, the replacement range is relative to the client document ( 0 is the beginning of the document) and NOT the string parameter. Currently, the replacement range is sent to the client via the kEventParamTextInputSendReplaceRange Carbon Event parameter. For this parameter to be used the client must support the TSMDocumentAccess protocol. If a client does not support the TSMDocumentAccess protocol the replacementRange parameter is ignored.

Version Information

Available in Monobjc Bridge: 10.6 (For Mac OS X 10.6 and later), 10.5 (For Mac OS X 10.5 and later)

Assembly: Monobjc.InputMethodKit (Module: Monobjc.InputMethodKit)