Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

setEndPoint method

Sets the endpoint of one range based on the endpoint of another range.

Syntax


HRESULT retVal = object.setEndPoint(how, SourceRange);

Parameters

how [in]

Type: BSTR

BSTR that specifies the endpoint to transfer using one of the following values.

StartToEnd

Move the start of the TextRange object to the end of the specified SourceRange parameter.

StartToStart

Move the start of the TextRange object to the start of the specified SourceRange parameter.

EndToStart

Move the end of the TextRange object to the start of the specified SourceRange parameter.

EndToEnd

Move the end of the TextRange object to the end of the specified SourceRange parameter.

SourceRange [in]

Type: IHTMLTxtRange

Pointer to the IHTMLTxtRange interface of the TextRange object from which the source endpoint is to be taken.

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Standards information

There are no standards that apply here.

Remarks

A text range has two endpoints: one at the beginning of the text range and one at the end. An endpoint can also be the position between two characters in an HTML document.

There are four possible endpoint locations in the following HTML.


<body><p><strong>abc

The possible endpoint locations are:

  • Before the letter a.
  • Between the letters a and b.
  • Between the letters b and c.
  • After the letter c.

This feature might not be available on platforms other than Microsoft Win32.

In Microsoft Internet Explorer 4.0, an endpoint is relative to text only, not HTML tags.

In Internet Explorer 4.0, an endpoint cannot be established between body and p. Specifying an endpoint between body and p is interpreted as if it occurs before the letter a.

See also

IHTMLTxtRange::compareEndPoints

 

 

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.