Options Page, Text Editor Node Properties

Note

This article applies to Visual Studio 2015. If you're looking for the latest Visual Studio documentation, see Visual Studio documentation. We recommend upgrading to the latest version of Visual Studio. Download it here

This document describes some pages (or properties collections) that are associated with the Text Editor category, DTE.Properties("TextEditor", <Property Page>), of the Options dialog box. The title of each subsection is the call that is used to access the Properties collection, and the table in each subsection lists the properties in the collection.

The Visual Basic macros in Controlling Options Settings demonstrate how to display current options and their values for each page of the Options dialog box.

General

DTE.Properties("TextEditor", "General")

Property Item Name Value Description
GoToAnchorAfterEscape Get/Set (Boolean) If True, pressing escape while there is a selection causes the insertion point to move to where the action that created the selection was initiated. False moves the insertion point to the other end of the selection.
DragNDropTextEditing Get/Set (Boolean) Determines whether you can drag a selected region of text from one location to another in the document for copy or cut/paste operations.
HorizontalScrollBar Get/Set (Boolean) Determines whether there is a horizontal scrollbar on editor windows.
VerticalScrollBar Get/Set (Boolean) Determines whether there is a vertical scroll bar on editor windows.
SelectionMargin Get/Set (Boolean) Determines whether there is space at the left of the text pane for special selection operations, drawing breakpoint icons, and so forth.
MarginIndicatorBar Get/Set (Boolean) Determines whether there is a vertical line dividing the left margin of the text pane from the main body of the text pane.
UndoCaretActions Get/Set (Boolean) If True. undo operations include insertion point motion, selection commands, and so forth, in addition to editing actions that modify the buffer.
AutoDelimiterHighlighting Get/Set (Boolean) Determines whether typing a closing delimiter causes the editor to highlight the opening delimiter. The editor always bolds the open delimiter regardless of the value of this property.
EditorEmulation Get/Set (Enum)
DetectUTF8WithoutSignature Get/Set (Boolean) Detects whether a file uses UTF-8 encoding when it does not have an encoding signature.
TrackChanges Get/Set (Boolean)

Plain Text

DTE.Properties("TextEditor", "PlainText")

The PlainText editor options affect the editor settings when text files are edited. Each programming language and Visual Studio package has its own specific Text Editor settings. For example, to view or change the Visual C# editor settings, use DTE.Properties("TextEditor", "CSharp") or DTE.Properties("TextEditor", "CSharp-Specific"). For the SQL Script editor settings, use DTE.Properties("TextEditor", "SQL ").

Property Item Name Value Description
AutoListMembers Get/Set (Boolean) Determines whether an available list of members automatically appears when a user types a period following a variable reference.
AutoListParams Get/Set (Boolean) Determines whether a description of an argument list automatically displays when the users types a "(" following a function name.
HideAdvancedMembers Get/Set (Boolean) Determines whether statement completion lists all members or only the commonly used ones.
VirtualSpace Get/Set (Boolean) Determines whether white space characters are displayed as graphics. Setting this to true causes the WordWrap property item (in this list) to be set to false.
WordWrap Get/Set (Boolean) Determines whether the view wraps long lines at word boundaries. Setting this to true causes the VirtualSpace property item (in this list) to be set to false.
WordWrapGlyphs Get/Set (Boolean) Displays a glyph at the end of a line; this indicates that the line wraps to the next line.
EnableLeftClickForURLs Get/Set (Boolean) Determines whether the editor underlines URLs and enables a single left-click for jumping to the URL in the system registered Web browser.
IndentStyle Get/Set (vsIndentStyle) Determines the indenting style: Default, Smart, or None.
TabSize Get/Set (Long) Represents the number of spaces that equal a tab. Setting an integer outside the range 1 to 60 (inclusive) fails.
InsertTabs Get/Set (Boolean) If True, TAB characters are used when indenting.
IndentSize Get/Set (Long) Represents the number of spaces that equals one indent level. Setting an integer value outside the range 1 to 60 (inclusive) fails.
ShowLineNumbers Get/Set (Boolean) Determines whether the view of a core editor document displays line numbers along the left margin.
ShowNavigationBar Get/Set (Boolean) Determines whether the drop-down lists and buttons appear at the top of editor windows.
CutCopyBlankLines Get/Set (Boolean) Cuts or copies blank lines when they are selected.

See Also

Controlling Options Settings Determining the Names of Property Items on Options Pages Options Page, Environment Node Properties Options Page, Fonts and Colors Node Properties