Colorizer Class

Article
04/29/2015

This class implements the IVsColorizer interface and is used to support syntax highlighting in an editor.

This API is not CLS-compliant.

Inheritance Hierarchy

Object
Microsoft.VisualStudio.Package.Colorizer

Namespace: Microsoft.VisualStudio.Package
Assemblies:   Microsoft.VisualStudio.Package.LanguageService (in Microsoft.VisualStudio.Package.LanguageService.dll)
  Microsoft.VisualStudio.Package.LanguageService.10.0 (in Microsoft.VisualStudio.Package.LanguageService.10.0.dll)
  Microsoft.VisualStudio.Package.LanguageService.12.0 (in Microsoft.VisualStudio.Package.LanguageService.12.0.dll)
  Microsoft.VisualStudio.Package.LanguageService.11.0 (in Microsoft.VisualStudio.Package.LanguageService.11.0.dll)
  Microsoft.VisualStudio.Package.LanguageService.9.0 (in Microsoft.VisualStudio.Package.LanguageService.9.0.dll)

Syntax

'Declaration
<CLSCompliantAttribute(False)> _
<ComVisibleAttribute(True)> _
Public Class Colorizer _
    Implements IVsColorizer, IDisposable

[CLSCompliantAttribute(false)]
[ComVisibleAttribute(true)]
public class Colorizer : IVsColorizer, IDisposable

[CLSCompliantAttribute(false)]
[ComVisibleAttribute(true)]
public ref class Colorizer : IVsColorizer, 
    IDisposable

[<CLSCompliantAttribute(false)>]
[<ComVisibleAttribute(true)>]
type Colorizer =  
    class 
        interface IVsColorizer 
        interface IDisposable 
    end

public class Colorizer implements IVsColorizer, IDisposable

The Colorizer type exposes the following members.

Constructors

	Name	Description
	Colorizer	Initializes the Colorizer class.

Top

Properties

	Name	Description
	Scanner	Returns the scanner being used.

Top

Methods

	Name	Description
	CloseColorizer	Called when the colorizer is disposed of.
	ColorizeLine	Obtains color and font attribute information for each character in the specified line of text.
	Dispose	Disposes the object.
	Equals	Determines whether the specified object is equal to the current object. (Inherited from Object.)
	Finalize	Called when the object is about to be destroyed. (Overrides Object.Finalize.)
	GetColorInfo	Returns the parsing state at the end of the line without returning any colorization information.
	GetHashCode	Serves as the default hash function. (Inherited from Object.)
	GetLineInfo	Returns color information about the specified line.
	GetStartState	Returns the initial parsing state.
	GetStateAtEndOfLine	Returns the parsing state at the end of the specified line.
	GetStateMaintenanceFlag	Called to determine if the colorizer requires per line state management.
	GetType	Gets the Type of the current instance. (Inherited from Object.)
	MemberwiseClone	Creates a shallow copy of the current Object. (Inherited from Object.)
	Resume	Called to resume use of the colorizer.
	Suspend	Called to suspend use of the colorizer.
	ToString	Returns a string that represents the current object. (Inherited from Object.)

Top

Remarks

The managed package framework (MPF) version of this class uses an IScanner object to handle all parsing tasks. The IScanner object communicates color information through the TokenInfo structure. The Colorizer class also helps the IScanner object track state by passing around a state variable the parser maintains.

This class handles colorization on a line by line basis.

Notes to Implementers

The MPF version of this class performs all the work necessary to colorize a line of code by interacting with the IScanner object. If you find you need additional functionality not supported in the existing Colorizer class, you must derive a class from the Colorizer class and return an instance of your class from GetColorizer.

The default implementation of GetColorizer instantiates the MPF version of Colorizer, passing to the Colorizer constructor an instance of the IScanner object obtained from GetScanner.

Notes to Callers

The colorizer object returned from GetColorizer is stored in the Source object when the Source object is created. The Source object handles all interactions with the colorizer so there is no need for any outside involvement with the colorizer.

The methods of this class are documented in case you need to implement your own version of the Source class.

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Partager via