ITextRange.MoveEnd method

Applies to Windows and Windows Phone

Moves the end position of the text range.

Syntax


int MoveEnd(
  TextRangeUnit unit, 
  int count
)

Parameters

unit

Type: TextRangeUnit

The unit by which to move the end position of the text range. The default value is Character.

count

Type: System.Int32 [.NET] | int32 [C++]

The number of units to move the end position of the text range. The default value is 1. If count is greater than zero, the end position moves forward, toward the end of the story. If count is less than zero, the end position move backward, toward the beginning of the story. If count is zero, the end position does not move.

Return value

Type: System.Int32 [.NET] | int32 [C++]

The actual number of units that the end position of the text range moved.

Remarks

If you move the end position of the text range so that it precedes the original start position, this method sets the start position to be equal to the new end position; that is, the text range becomes a degenerate range (insertion point).

This method moves the end position in a logical direction rather than a physical direction. That is, movement is toward the end or start of a story. Depending on the language, moving the end position toward the end of the story could result in the end position moving either left or right.

For more information, see the discussion in ITextRange and the Remarks section of ITextRange.Move.

Requirements

Minimum supported client

Windows 8

Minimum supported server

Windows Server 2012

Minimum supported phone

Windows Phone 8.1 [Windows Runtime apps only]

Namespace

Windows.UI.Text
Windows::UI::Text [C++]

Metadata

Windows.winmd

See also

ITextRange
ITextRange.Move
ITextRange.MoveStart

 

 

Show:
© 2015 Microsoft