styleAttributes 參數

使用 styleAttributes 參數,可以設定或查詢某個樣式字元或其中一項內建編輯器樣式的樣式屬性。 樣式字元通常是由文件剖析器所設定的。 剖析器會使用樣式字元,來強調顯示程式語言來源文件的語法。

樣式屬性可指定於顯示文字時所用的顏色(前景、背景)及特效(加底線、加刪除線等等)。

可用性

query 指令
set 指令

範圍

現行視圖。

語法

query styleAttributes.{ styleCharacter
                      | addedLines
                      | background
                      | currentLine
                      | cursor
                      | default
                      | deletedLines
                      | emphasis
                      | expandHide
                      | formatLine
                      | messageLine
                      | parserDefault
                      | parserMessage
                      | prefixArea
                      | prefixText
                      | selection
                      | statusLine
                      }
set styleAttributes.{ styleCharacter
                    | addedLines
                    | background
                    | currentLine
                    | cursor
                    | default
                    | deletedLines
                    | emphasis
                    | expandHide
                    | formatLine
                    | messageLine
                    | parserDefault
                    | parserMessage
                    | prefixArea
                    | prefixText
                    | selection
                    | statusLine
                    }
                    [ foregroundRed
                      foregroundGreen
                      foregroundBlue
                      backgroundRed
                      backgroundGreen
                      backgroundBlue
                      [ underline ]
                      [ strikeout ]
                      [ squiggle ]
                      [ outline ]
                      [ bold ]
                      [ italic ]
                    ] 

參數

styleCharacter styleCharacter 限定元是用來指示您想查詢或設定的樣式字元。 樣式字元是與 set style 指令一起使用。

樣式字元 '!' 及以下的字元是保留字元。'!' 樣式字元是當成預設的樣式字元使用。 未經剖析的新文字,會使用預設樣式字元的屬性來顯示。
addedLines 使用 addedLines 限定元,以指出用來顯示由 compare 指令所偵測到之新增行的樣式屬性。
background 使用 background 限定元,以指出您是否要查詢或設定背景的樣式屬性。background 樣式用於製作不顯示文字元素的文字區域部份。
currentLine 使用 currentLine 限定元,以指出當 highlightCurrentLine 設定為開啟時,用來強調顯示現行元素的樣式屬性。
cursor 使用 cursor 限定元,以指出用來顯示游標的樣式屬性。
default 使用 default 限定元,以指示在未指示其他樣式屬性時,應該使用的樣式屬性。 如果編輯器遇到未定義的樣式字元時,就可能發生上述的狀況。 如果未設定元素文字的樣式字元時,也會使用上述的樣式。
deletedLines 使用 deletedLines 限定元,以指出用來顯示由 compare 指令所偵測到之刪除行的樣式屬性。
emphasis 使用 emphasis 限定元,以指出用來強調文字的樣式屬性。 當搜尋順利完成時,通常文字是由 findText 指令或 locate 指令來強調的。
expandHide 使用 expandHide 限定元,以指出用來顯示展開/隱藏區域的樣式屬性。 請參閱 expandHide 參數。
formatLine 使用 formatLine 限定元,以指出用來顯示格式行的樣式屬性。
messageLine 使用 messageLine 限定元,以指出用來顯示訊息行的樣式屬性。
parserDefault 使用 parserDefault 限定元,以指示用來作為文件剖析器所使用之預設樣式屬性的樣式屬性。 此設定通常是由可延伸 com.ibm.lpex.LpexCommonParser 的文件剖析器所使用。 當這些剖析器的 tokenHighlight 內容關閉時,這些樣式屬性也會使用於所有樣式字元中。
parserMessage 使用 parserMessage 限定元,以指出文件剖析器在顯示內嵌錯誤及參考訊息時所用的樣式屬性。 此設定通常是由可延伸 com.ibm.lpex.LpexCommonParser 的文件剖析器所使用。
prefixArea 使用 prefixArea 限定元,以指出用來顯示字首區域的樣式屬性。 請參閱 prefixArea 參數。
prefixText 使用 prefixText 限定元,以指出用來顯示已鍵入字首區域之文字的樣式屬性。
selection 使用 selection 限定元,以指出用來顯示文字選項的樣式屬性。
statusLine 使用 statusLine 限定元,以指出用來顯示狀態行的樣式屬性。
foregroundRed 使用 foregroundRed 參數,以指出前景顏色的紅色元件。foregroundRed 必須為介於 0 到 255 間的整數。
foregroundGreen 使用 foregroundGreen 參數,以指出前景顏色的綠色元件。foregroundGreen 必須為介於 0 到 255 間的整數。
foregroundBlue 使用 foregroundBlue 參數,以指出前景顏色的藍色元件。foregroundBlue 必須為介於 0 到 255 間的整數。

某些功能,如 markStyle 參數,支援具有僅限背景樣式屬性的樣式。 「若只要指定與背景有關的樣式屬性,請對前景顏色的全部三個元件使用 -1 值。」
backgroundRed 使用 backgroundRed 參數,以指出背景顏色的紅色元件。backgroundRed 必須為介於 0 到 255 間的整數。
backgroundGreen 使用 backgroundGreen 參數,以指出背景顏色的綠色元件。backgroundGreen 必須為介於 0 到 255 間的整數。
backgroundBlue 使用 backgroundBlue 參數,以指出背景顏色的藍色元件。backgroundBlue 必須為介於 0 到 255 間的整數。
underline 使用可選用的 underline 參數,以指出文字應畫底線。
strikeout 使用選用的 strikeout 參數,以指出文字是否應該顯示加刪除線標記。
squiggle 使用選用的 squiggle 參數,以指出文字是否應該顯示波形底線。
outline 使用可選用的 outline 參數,以指出文字應加以描邊。
bold 使用選用的 bold 參數,以指出是否應該將文字以粗體表示。 這個屬性目前在編輯器中的使用有限。
italic 使用選用的 italic 參數,以指出是否應該將文字以斜體表示。 這個屬性目前在編輯器中的使用有限。

說明

若您指定無參數的 set styleAttributes.styleCharacter,將會清除指定樣式字元的樣式屬性。若您指定其中一個無參數的內建樣式,則會將內建樣式的樣式屬性復置為預設設定。

部分編輯器樣式不會使用某些樣式屬性特效。

範例

query styleAttributes.e
set styleAttributes.e 255 0 0 255 255 255 strikeout
set styleAttributes.currentLine -1 -1 -1 238 240 249
query styleAttributes.messageLine 

相關參照
query 指令
set 指令
saveAsHtml 指令
expandHide 參數
highlightCurrentLine 參數
markStyle 參數
prefixArea 參數
style 參數
updateProfile.paletteAttributes 參數
copy 動作