Macro Reference — Selection Object

# Selection Object

## Properties

Average | Retrieves the average of the numbers contained in the selection.
Count | Retrieves the number of selections in the current document.
IsActiveEndGreater | Indicates whether the active point is equal to the bottom point.
IsEmpty | Indicates whether the active point is equal to the anchor point.
Mode | Sets or retrieves a flag indicating the selection mode.
OverwriteMode | Sets or retrieves a flag indicating the overwrite or insert mode.
Sum | Retrieves the sum of the numbers contained in the selection.
Text | Retrieves the selected text, or inserts a string at the cursor position.

## Methods

BatchFind | Searches for multiple strings.
BatchReplace | Replaces multiple strings.
ChangeCase | Changes the case of the selected text.
ChangeWidth | Changes the width of the selected text.
CharLeft | Moves the cursor the specified number of characters to the left.
CharRight | Moves the cursor the specified number of characters to the right.
ClearBookmark | Clears a bookmark on the current line.
Collapse | Collapses the selection to the active point.
Copy | Copies the selection to the Clipboard.
CopyLink | Copies the hyperlink at the cursor to the Clipboard.
Cut | Moves the selected text to the Clipboard.
Delete | Deletes the contents of the selection.
DeleteLeft | Deletes the contents of the selection, or the specified number of characters to the left of the cursor.
DestructiveInsert | Inserts text, overwriting the existing text.
DuplicateLine | Duplicates the current line.
EndOfDocument | Moves the cursor to the end of the document.
EndOfLine | Moves the cursor to the end of the current line.
ExtractFrequent | Extracts frequently used strings into a new document.
Find | Searches for the specified string.
FindRepeat | Repeats the previous search for the same string.
Format | Inserts or deletes newline characters in the selection.
GetActivePointX | Returns the column number of the cursor position.
GetActivePointY | Returns the line number of the cursor position.
GetAnchorPointX | Returns the column number of the origin point of the selection.
GetAnchorPointY | Returns the line number of the origin point of the selection.
GetBottomPointX | Returns the column number of the bottom of the selection.
GetBottomPointY | Returns the line number of the bottom of the selection.
GetTopPointX | Returns the column number of the top of the selection.
GetTopPointY | Returns the line number of the top of the selection.
GoToBrace | Moves the cursor to the corresponding bracket / brace.
Indent | Indents the selected lines by the specified number of indentation levels.
InsertDate | Inserts the current time and date.
InsertFromFile | Inserts the contents of the specified file at the cursor position.
LineDown | Moves the cursor down a specified number of lines.
LineOpen | Inserts an empty line between two lines.
LineUp | Moves the cursor up a specified number of lines.
NewLine | Inserts the specified number of newline characters at the cursor.
NextBookmark | Moves to the next bookmark in the document.
OpenLink | Opens the hyperlink at the cursor.
PageDown | Moves the cursor the specified number of pages down in the document.
PageUp | Moves the cursor the specified number of pages up in the document.
Paste | Inserts the Clipboard contents at the cursor.
PreviousBookmark | Moves to the previous bookmark in the document.
Replace | Replaces a string in the document.
SelectAll | Selects the entire document.
SelectColumn | Selects specified columns in a CSV mode.
SelectLine | Selects a line at the cursor.
SelectWord | Selects an entire word at the cursor.
SetActivePoint | Moves the cursor position and optionally extends the selection.
SetAnchorPoint | Sets the origin point of the selection.
SetBookmark | Sets a bookmark at the cursor position.
Sort | Sorts or removes duplicate split strings in the selection.
StartOfDocument | Moves the cursor to the start of the document.
StartOfLine | Moves the cursor to the start of the line.
Tabify | Converts spaces to tabs in the selection.
TagJump | Jumps to a tag at the cursor.
UnIndent | Removes indents from the selected text by the specified number of indentation levels.
Untabify | Converts tabs to spaces in the selection.
WordLeft | Moves the cursor the specified number of words to the left.
WordRight | Moves the cursor the specified number of words to the right.

## Version

Supported on EmEditor Professional Version 4.00 or later.