ITextRange::SetStart method (tom.h)

Sets the character position for the start of this range.

Syntax

HRESULT SetStart(
  [in] long cpFirst
);

Parameters

[in] cpFirst

Type: long

The new character position for the start of the range.

Return value

Type: HRESULT

The method returns an HRESULT value. If the method succeeds, it returns S_OK. If the method fails, it returns S_FALSE.

Remarks

Note that if cpFirst is greater than the range's end position, this method sets the end position equal to cpFirst, making the range an insertion point. If this range is the selection, the start position becomes the active end and is scrolled into view if the display isn't frozen.

ITextRange::SetEnd sets the range's end position, and ITextRange::SetRange sets both range ends simultaneously. The following example shows how to convert a nondegenerate range into a degenerate one (insertion point).

range.End = range.Start

Similarly, range.Start = range.End converts the range into an insertion point at the end position.

The following example adds 1 to the end position, if it is not at the end of the story.

range.End = range.End + 1

This also makes the end position the active end of the range, and it can turn a degenerate range into a nondegenerate one.

Requirements

See also

Conceptual

GetStart

ITextRange

Reference

SetEnd

SetRange

Text Object Model