ITextRange::EndOf method

Moves this range's ends to the end of the last overlapping Unit in the range.

Syntax


HRESULT EndOf(
   long Unit,
   long Extend,
   long *pDelta
);

Parameters

Unit

Type: long

Unit to use. Default value: tomWord. For a list of the other Unit values, see the discussion under ITextRange.

Extend

Type: long

Indicator of how the shifting of the range ends is to proceed. It can be one of the following.

0 or tomMoveCollapses a nondegenerate range to the End of the original range by moving the insertion point. This is the default.
1 (or tomExtend)Moves End to the end of the overlapping Unit. Does not move Start.

 

pDelta

Type: long*

The count of characters that End is moved past. The value of the pointer can be null. On return, the value of pDelta is the number of characters the insertion point or End is moved plus 1 if a collapse occurs to the entry End. If the range includes the final CR (carriage return) (at the end of the story) and Extend = tomMove, then pDelta is set to –1, to indicate that the collapse occurred before the end of the range (because an insertion point cannot exist beyond the final CR).

Return value

Type: HRESULT

The method returns an HRESULT value. If the method succeeds, it returns S_OK. If the method fails, it returns one of the following error codes. For more information about COM error codes, see Error Handling in COM.

Return codeDescription
E_NOTIMPL

Unit is not supported.

S_FALSE

Failure for some other reason.

 

Remarks

For comparison, the ITextRange::StartOf method moves the range ends to the beginning of the first overlapping Unit in the range. Note, the ITextRange::StartOf and ITextRange::EndOf methods differ from the HomeKey and EndKey methods in that the latter extend from the active end, whereas ITextRange::StartOf extends from Start and ITextRange::EndOf extends from End. If the range is an insertion point on a boundary between Units, ITextRange::EndOf does not change End. In particular, calling ITextRange::EndOf (tomCharacter, *, *) does not change End except for an insertion point at the beginning of a story.

Requirements

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Tom.h

DLL

Msftedit.dll

See also

Reference
ITextRange
StartOf
EndKey
HomeKey
Conceptual
Text Object Model

 

 

Show: