IVsColorizer.ColorizeLine 方法
指定的文字會以顏色標示。
命名空間： Microsoft.VisualStudio.TextManager.Interop
組件： Microsoft.VisualStudio.TextManager.Interop (在 Microsoft.VisualStudio.TextManager.Interop.dll 中)
語法
'宣告
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
參數
iLine
類型：Int32[in]會以色彩標示的行。
iLength
類型：Int32[in]減去行尾標記直線的長度 (CR，LF，CRLF 組或 0 (EOF))。
pszText
類型：IntPtr[in]線條的文字 (最多可檢查iLength個字元)。
iState
類型：Int32[in]Colorizer 狀態開頭的行。
pAttributes
類型：array<UInt32[][] out要填滿文字的色彩屬性的陣列。 陣列包含每個字元以色彩標示，列和其他項目右邊的最後一個字元代表背景的色彩空間中的一個成員。 這個陣列表示iLength + 1 個字元。
成員的pAttributes陣列可能包含可以被遮罩中所提供的各種值的位元COLORIZER_ATTRIBUTE列舉型別，以取得所需的資訊。 如需詳細資訊，請參閱 COLORIZER_ATTRIBUTE。
傳回值
類型：Int32
傳回在行結尾處的 colorizer 的狀態。
備註
COM 簽章
從 textmgr.idl：
HRESULT IVsColorizer::ColorizeLine(
[in] long iLine,
[in] long iLength,
[in] const WCHAR *pszText,
[in] long iState,
[out] ULONG * pAttributes
);
任何實作這個方法必須剖析輸入的線 (pszText) 以色彩標示的語彙基元。
對應的陣列元素傳回在指定的行中每個字元，則請pAttributes到 colorizable 的項目，例如註解、 識別項，以及數字的語言服務的陣列含有索引。
傳回的值pAttributes陣列是由所提供的預設值可設定色彩項目到索引Visual Studio或語言服務所提供的自訂可設定色彩項目 (請參閱GetColorableItem在IVsProvideColorableItems介面)。 索引為 0 永遠表示的預設文字色彩，如所提供的Visual Studio。
Colorizer 應該提供，狀態啟動，並傳回其目前的狀態，因為它是快取，且稍後為啟動狀態時，提供下一行以色彩標示。 指定的索引陣列保證一個項目超過行中的字元數。 最後一個項目用來決定背景色彩] 旁的該行的最後一個字元的間距。
Colorizer 應該將標記視為與人類的自然語言文字的文字HUMAN_TEXT_ATTR位元。 這個位元應該設定註解和字串，不包含分隔符號的內容，用來取得正確的雙向文字的版面配置。 HUMAN_TEXT_ATTR位元也用來決定何時套用自然語言的規則，而非程式設計語言規則，比方說，如拼字檢查及 word 的界限。
.NET Framework 安全性
- 完全信任立即呼叫者。這個成員無法供部分信任的程式碼使用。如需詳細資訊，請參閱從部分受信任程式碼使用程式庫。