Colorizer.GetStateMaintenanceFlag Method

Artigo
10/31/2012

Called to determine if the colorizer requires per line state management.

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

Syntax

'Declaração
Public Overridable Function GetStateMaintenanceFlag ( _
    <OutAttribute> ByRef flag As Integer _
) As Integer

public virtual int GetStateMaintenanceFlag(
    out int flag
)

Parameters

flag
Type: System.Int32%
[out] Returns nonzero if the colorizer requires parsing state to be tracked per line; otherwise, returns zero.

Return Value

Type: System.Int32
If successful, returns S_OK; otherwise, returns an error code.

Implements

IVsColorizer.GetStateMaintenanceFlag(Int32%)

Remarks

This method is used to determine if the colorizer requires managing the parsing state for each line of source. If the colorizer does require managing line by line state, the editing performance may suffer. Note that the managed package framework version of Colorizer assumes a line-by-line state.

This method is an implementation of GetStateMaintenanceFlag.

The base method returns a 1 if the suspended state is 0; otherwise, it returns a 0.

The colorizer can be suspended by a call to Suspend and resumed by a call to Resume. This method indicates the current suspension state. The colorizer is suspended while handling code snippet expansion (colorization is unnecessary until the expansion is completed). Note that the base class does not pay attention to this flag although it is maintained.

.NET Framework Security

Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.

Compartilhar via