Git Product home page Git Product logo

editorguidelines's Introduction

Editor Guidelines

A Visual Studio extension that adds vertical column guides to the text editor.

Visual Studio Marketplace Visual Studio Marketplace Rating Visual Studio Marketplace Downloads

The extension adds vertical column guides behind your code. This is useful if you are trying to tabulate columns of data or if you want to ensure that your lines don't extend beyond a certain length. You specify where the guides go and what color they should be.

Build Status

Getting Started

Download and run the extension (VSIX) for Visual Studio 2012 or later from the Visual Studio Marketplace or, from within Visual Studio, search for "Editor Guidelines" in the "Extensions and Updates" UI.

Control guidelines via the context (right-click) menu on the editor surface. You will see a Guidelines flyout with three commands:

GuidelinesContextMenu

  • When Add Guideline is selected, a vertical dashed line will be drawn at the same position as the caret (insertion point).
  • Remove Guideline will remove any guideline at the current insertion point.
  • Remove All Guidelines does exactly that.

These commands may also be accessed from Visual Studio's Command Window.

GuidelinesCommandWindow

Note that the column numbers used for the Edit.AddGuideline and Edit.RemoveGuideline commands refer to the right side of the given column of text. i.e. To place a guide to the right of column 80, use Edit.AddGuideline 80. To place a guide to the left of the first column use Edit.AddGuideline 0.

You can change the guideline color from the Fonts and Colors page in Tools|Options. Look for Guideline in the Text Editor category:

GuidelinesToolsOptions

.editorconfig support (VS 2017 and VS 2019 only)

For VS 2017 and VS 2019, the position of guidelines can be overridden via settings in .editorconfig files. Set the guidelines property to a list of column values. The following example sets guidelines at columns 80 and 120 for C# and VB files and a single guideline at column 80 for all other files.

# All files
[*]
guidelines = 80

# C# or VB files
[*.{cs,vb}]
guidelines = 80, 120

You can set the guideline style like this:

[*]
# Named color format
guidelines_style = 1px dotted black

[*.{cs,vb}]
# ARGB color format (red with 25% opacity)
guidelines_style = 2.5px solid 40ff0000

As shown, you can have different styles for different file types. There are three different drawing styles:

  • solid
  • dotted
  • dashed

As the examples show, colors may be named or in RGB or ARGB (hexadecimal) format. The available color names are from WPF's Colors collection (System.Windows.Media.Colors).

As the following example shows, you can set the style for each guideline separately. Three guidelines are defined. The first two define custom styles. The third, at column 132 doesn't specify a style, so it will be drawn using the default style which, if not specified via guidelines_style, will take its color from Fonts & Colors.

[*]
guidelines = 40 1px dotted black, 80 10px solid 30B0ED4C, 132

To learn more about .editorconfig see https://aka.ms/editorconfigdocs

Note: When guidelines are set via .editorconfig they override any other guidelines set via the context menus or command window.

Note: This extension collects and transmits anonymized usage statistics to the extension author for product improvement purposes.

editorguidelines's People

Contributors

pharring avatar sharwell avatar madskristensen avatar randomnoise avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.