針對建立設定檔的元素使用陰影
您可以配置可以區分設定檔、設定檔群組或個別值的陰影。為一或多種類型的設定檔資訊指定顏色,可為供文件類型使用的設定檔提供視覺表示,且已在文件中為其元素建立設定檔。
陰影在支援文件類型的設定檔組態檔案 (PCF) 中配置。請參照 Profile 元素的 shadingBackground 屬性。
當在 PCF 中配置之後,可針對文件使用 set showprofileshading 檢視指令啟動陰影。陰影將顯示在下列位置:
• 在
套用設定檔對話方塊中 - 設定檔群組、子類別與值將在 PCF 中以與其相關聯的顏色顯示。
當您從已啟用設定檔陰影的「編輯檢視」中叫用對話方塊,且使用陰影屬性設定此設定檔時,可以看見。
• 在與 PCF 相關聯的文件中 - 具有在 PCF 中配置了相關聯陰影顏色之設定檔值的元素將以該顏色顯示在「編輯檢視」中。這些文件也將在「文件地圖」檢視與「欄檢視」中顯示建立設定檔之元素的圖示
。
除了設定檔、設定檔群組與個別值的顏色以外,您也可以指定要針對文件類型用於設定檔衝突的顏色。如果已為元素指派不同顏色的多個設定檔值,該元素將會以此顏色顯示。在 PCF 中透過 ProfileClasses 元素的 conflictShadingBackground 屬性配置衝突顏色。
請注意設定檔陰影的下列實行註記:
• 會將針對主「設定檔」別名配置的顏色視為預設顏色。未指定其自身設定檔陰影的任何設定檔值都將使用預設顏色。
• 如果已為「設定檔」子類別 (資料夾) 配置顏色,則資料夾中未配置其自身設定檔陰影的任何值都將使用資料夾顏色。
• 當兩個設定檔值都指定相同的顏色時,不會將其視為衝突。
• 在表格中,如果透過建立設定檔為原型標籤設定的背景顏色與為個別字元格設定的背景顏色一致,則可能會發生衝突。在此實例中,如果字元格的 force 標記為開啟,字元格將繼承背景顏色。否則,將會顯示字元格自己的陰影。
當透過「設定檔」陰影設定陰影顏色時,force 標記將會設定為開啟。字元格的顏色將會遭到置換。這也表示為陰影建立設定檔將會置換也設定陰影的任何內容。
在「文件地圖」檢視中,表格圖示將不會由設定檔圖示置換。專門設定了設定檔的標籤也會將其標籤名稱設定為設定檔陰影顏色,包括表格標籤。
• 當使用 DITA 主題與地圖時,設定檔陰影將不會顯示 DITA 屬性階層的效果。例如,如果父件設定了建立設定檔的屬性 audience="novice" 且子元素有 audience="expert",子件便有效設定了 audience="novice expert",其不可以有陰影顏色。
下列函數支援設定檔陰影:
• profile_shadingbackground()
• profile_conflictshadingbackground()
• profile_values_shadingbackground()
• profilenode_shadingbackground()
• dlgitem_set_background_at()
• dlgitem_get_background_at()
• dlgitem_set_foreground_at()
• dlgitem_get_foreground_at()