IHTMLSelection interface
Represents the active selection, which is typically a highlighted block of text or other elements in the document. The active selection can be used to complete an action issued by a user or a script.
Members
The IHTMLSelection interface inherits from the IDispatch interface. IHTMLSelection also has these types of members:
- Methods
- Properties
Methods
The IHTMLSelection interface has these methods.
| Method | Description |
|---|---|
| addRange | Adds a Range to the current selection. |
| collapse | Replaces the current selection with an empty selection (or a caret) at the given offset. |
| collapseToEnd | Collapses or sets the insertion point or caret at the end of a selection object. |
| collapseToStart | Collapses, or sets the insertion point or caret at the beginning of a selection object. |
| deleteFromDocument | Deletes the selected nodes from a document. |
| getRangeAt | Returns a specified Range from a selection. The Range is specified by an index and cannot be greater than the number that is returned by IHTMLSelection::rangeCount. |
| removeAllRanges | Removes all ranges from a selection. |
| removeRange | Removes a range from a selection. |
| selectAllChildren | Replaces the current selection with all the contents of the given node. |
Properties
The IHTMLSelection interface has these properties.
| Property | Description |
|---|---|
Returns the element or node that contains the start of the selection. |
|
Retrieves the starting position of a selection that is relative to the IHTMLSelection::anchorNode. |
|
Retrieves the element or node that contains the end of a selection. |
|
Retrieves the end position of a selection that is relative to the IHTMLSelection::focusNode. |
|
Retrieves whether a selection is collapsed or empty. |
|
Returns the number of ranges in a selection |
Requirements
Minimum supported client |
Windows Vista with SP1, Windows 7 |
Minimum supported server |
Windows Server 2008 R2 |
Header |
Mshtml.h |
IDL |
Mshtml.idl |
DLL |
Mshtml.dll |