为配置元素使用底纹
可以配置底纹以区分配置文件、配置文件组或各个值。通过对一种或多种类型的配置文件信息指定颜色,可以直观地反映某一文档类型适用的配置,以及文档中已配置的元素。
在支持文档类型的配置文件 (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()