Metodo IVsColorizer.ColorizeLine
Colore del testo specificato.
Spazio dei nomi: Microsoft.VisualStudio.TextManager.Interop
Assembly: Microsoft.VisualStudio.TextManager.Interop (in Microsoft.VisualStudio.TextManager.Interop.dll)
Sintassi
'Dichiarazione
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
Parametri
iLine
Tipo: Int32[in] Riga da colori.
iLength
Tipo: Int32[in] Lunghezza della riga meno il marcatore di fine riga (coppia di DA, di LF, di CRLF, o 0 (EOF).
pszText
Tipo: IntPtr[in] Il testo della riga (esaminare fino a iLength caratteri).
iState
Tipo: Int32[in] I colorizer di stato all'inizio della riga.
pAttributes
Tipo: array<UInt32[][out] Una matrice degli attributi di colore da rimpiazzare il testo. La matrice contiene un membro per ogni carattere della riga colorata e un elemento aggiuntivo che rappresenta il colore di sfondo dello spazio a destra dell'ultimo carattere. questa matrice è iLength + 1 caratteri tempo.
Membri di pAttributes la matrice può contenere i bit che possono essere mascherati con diversi valori forniti in COLORIZER_ATTRIBUTE enumerazione per ottenere le informazioni necessarie. Per ulteriori informazioni, vedere COLORIZER_ATTRIBUTE.
Valore restituito
Tipo: Int32
Restituisce i colorizer di stato alla fine della riga.
Note
Firma COM
da textmgr.idl:
HRESULT IVsColorizer::ColorizeLine(
[in] long iLine,
[in] long iLength,
[in] const WCHAR *pszText,
[in] long iState,
[out] ULONG * pAttributes
);
Qualsiasi implementazione di questo metodo deve analizzare la linea di input (pszText) per token colorino.
Per ogni carattere in una determinata riga, l'elemento della matrice corrispondente restituito in pAttributes contiene un indice nella matrice del servizio di linguaggio degli elementi colorizable, quali commenti, gli identificatori e numeri.
i valori restituiti in GetColorableItem la matrice è indici negli elementi colorabili predefiniti forniti da IVsProvideColorableItems o gli elementi colorabili personalizzati forniti dal servizio di linguaggio (vedere di pAttributes in Visual Studio interfaccia). Un indice 0 è sempre il colore del testo predefinito come fornito da Visual Studio.
Il colorizer deve iniziare con stato fornito e restituisce il relativo stato corrente, memorizzato nella cache versioni successive e fornito uno stato iniziale quando la riga successiva viene colorata. La matrice di indice fornita viene sempre più tempo per essere un elemento al numero di caratteri nella riga. L'ultimo elemento viene utilizzato per determinare il colore di sfondo dello spazio a destra dell'ultimo carattere della riga.
Un colorizer necessario contrassegnare il testo venga considerato come testo del linguaggio naturale umane con HUMAN_TEXT_ATTR bit. Questo bit deve essere impostato per il contenuto dei commenti e delle stringhe, esclusi i delimitatori e viene utilizzato per ottenere il layout corretto di testo bidirezionale. HUMAN_TEXT_ATTR il bit viene utilizzato per determinare quando applicare le regole del linguaggio naturale anziché le regole del linguaggio di programmazione, ad esempio, per il controllo ortografico e i limiti di parola.
Sicurezza di .NET Framework
- Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per altre informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.