Model of a Legacy Language Service

  • Article

Applies to: yesVisual Studio noVisual Studio for Mac

Note

This article applies to Visual Studio 2017. 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

A language service defines the elements and features for a specific language, and is used to provide the editor with information specific to that language. For example, the editor needs to know the elements and keywords of the language in order to support syntax coloring.

The language service works closely with the text buffer managed by the editor and the view that contains the editor. The Microsoft IntelliSense Quick Info option is an example of a feature provided by a language service.

A Minimal Language Service

The most basic language service contains the following two objects:

  • The language service implements the IVsLanguageInfo interface. A language service has information about the language, including its name, file name extensions, code window manager, and colorizer.

  • The colorizer implements the IVsColorizer interface.

    The following conceptual drawing shows a model of a basic language service.

    Language Service Model graphic Basic language service model

    The document window hosts the document view of the editor, in this case the Visual Studio core editor. The document view and the text buffer are owned by the editor. These objects work with Visual Studio through a specialized document window called a code window. The code window is contained in an IVsWindowFrame object that is created and controlled by the IDE.

    When a file with a given extension is loaded, the editor locates the language service associated with that extension and passes to it the code window by calling the GetCodeWindowManager method. The language service returns a code window manager, which implements the IVsCodeWindowManager interface.

    The following table provides an overview of the objects in the model.

Component Object Function
Text buffer VsTextBuffer A Unicode read/write text stream. It is possible for text to use other encodings.
Code window VsCodeWindow A document window that contains one or more text views. When Visual Studio is in multiple-document interface (MDI) mode, the code window is an MDI child.
Text view VsTextView A window that lets the user navigate and view text by using the keyboard and mouse. A text view appears to the user as an editor. You can use text views in ordinary editor windows, the Output window, and the Immediate window. Additionally, you can configure one or more text views within a code window.
Text manager Managed by the SVsTextManager service, from which you obtain an IVsTextManager pointer A component that maintains common information shared by all the components described previously.
Language service Implementation dependent; implements IVsLanguageInfo An object that provides the editor with language-specific information such as syntax highlighting, statement completion, and brace matching.

See also