IVsColorizer.ColorizeLine-Methode
Farbig stellt den angegebenen Text dar.
Namespace: Microsoft.VisualStudio.TextManager.Interop
Assembly: Microsoft.VisualStudio.TextManager.Interop (in Microsoft.VisualStudio.TextManager.Interop.dll)
Syntax
'Declaration
Function ColorizeLine ( _
iLine As Integer, _
iLength As Integer, _
pszText As IntPtr, _
iState As Integer, _
<OutAttribute> pAttributes As UInteger() _
) As Integer
int ColorizeLine(
int iLine,
int iLength,
IntPtr pszText,
int iState,
uint[] pAttributes
)
int ColorizeLine(
[InAttribute] int iLine,
[InAttribute] int iLength,
[InAttribute] IntPtr pszText,
[InAttribute] int iState,
[OutAttribute] array<unsigned int>^ pAttributes
)
abstract ColorizeLine :
iLine:int *
iLength:int *
pszText:IntPtr *
iState:int *
pAttributes:uint32[] byref -> int
function ColorizeLine(
iLine : int,
iLength : int,
pszText : IntPtr,
iState : int,
pAttributes : uint[]
) : int
Parameter
iLine
Typ: Int32[in] Getönt Zeile werden soll.
iLength
Typ: Int32[in] Die Länge der Zeile am Zeilenende (abzüglich des Markers, Wagenrücklauf- Zeilenvorschub-, EOF) oder 0 (CRLF-Paare).
pszText
Typ: IntPtr[in] Der Text der Zeile ( iLength überprüfen Sie so viele Zeichen).
iState
Typ: Int32[in] Der Zustand der farbigen Darstellung zu Beginn der Zeile.
pAttributes
Typ: array<UInt32[][out] Ein Array von Farben dargestellt werden Attribute, Text. Das Array enthält einen Member darfarbig für jedes Zeichen in der angegebenen Zeile und ein zusätzliches Element, das die Hintergrundfarbe des Leerraums auf der rechten Seite des letzten Zeichens darstellt. Dieses Array ist iLength + 1 Zeichen lang.
Member des Arrays pAttributes Bits enthalten möglicherweise mit unterschiedlichen Werten maskiert werden können, die in der COLORIZER_ATTRIBUTE-Enumeration bereitgestellt werden, um die erforderlichen Informationen zu erhalten. Weitere Informationen finden Sie unter COLORIZER_ATTRIBUTE.
Rückgabewert
Typ: Int32
Gibt den Zustand der farbigen Darstellung am Ende der Zeile zurück.
Hinweise
COM-Signatur
Von textmgr.idl:
HRESULT IVsColorizer::ColorizeLine(
[in] long iLine,
[in] long iLength,
[in] const WCHAR *pszText,
[in] long iState,
[out] ULONG * pAttributes
);
Jede Implementierung dieser Methode muss die Eingabezeile (pszText). tönen Token für die Analyse
Für jedes Zeichen in der angegebenen Zeile enthält das entsprechende Arrayelement, das in pAttributes zurückgegeben wird, einen Index für das Array des Sprachdiensts von colorizable Elementen, Kommentaren, z. B. ganze Zahlen und Bezeichnern
Die Werte, die im pAttributes Array zurückgegeben werden, werden Indizes in der färbbaren Elemente, die von Visual Studio angegeben werden oder die benutzerdefinierten färbbaren Elemente, die aus dem Sprachdienst angegeben werden (siehe GetColorableItem in der IVsProvideColorableItems-Schnittstelle). Ein Index von 0 bedeutet immer die Farbe Standardtext, wie durch Visual Studioangegeben.
Die farbige Darstellung sollte im angegebenen Zustand beginnen und gibt seinen aktuellen Zustand zurück, die später während der Ausführung des Anfangs zwischengespeichert und bereitgestellt wird, wenn die nächste Zeile darfarbig gestellt wird. Das angegebene Index array ist gewährleistet, dass ein Element ist länger als die Anzahl der Zeichen in der Zeile. Das letzte Element wird verwendet, um die Hintergrundfarbe des Leerraums auf der rechten Seite des letzten Zeichens in der Zeile zu bestimmen.
Eine farbige Darstellung als menschlicher sollten den Text in einer natürlichen Sprache mit dem HUMAN_TEXT_ATTR Bit Text behandelt markieren. Das Bit sollte für den Inhalt von Kommentaren und von Zeichenfolgen ohne Trennzeichen festgelegt und wird verwendet, um das richtige zu erhalten, bidirektionale Lay-out des Texts. Das HUMAN_TEXT_ATTR Bit wird auch verwendet, um zu bestimmen, wann Regeln für natürliche Sprachen, z. B. steuern anstelle von Programmiersprachen und Rechtschreibprüfung für Wortgrenzen verwendet.
.NET Framework-Sicherheit
- Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.