Schattierung für Elemente mit Profil verwenden
Sie können Schattierungen konfigurieren, die zwischen Profilen, Profilgruppen oder einzelnen Werten unterscheiden. Das Festlegen einer Farbe für eine oder mehrere Arten von Profilinformationen bietet eine visuelle Darstellung der für einen Dokumenttyp verfügbaren Profilzuweisungen und der Elemente, denen in einem Dokument ein Profil zugewiesen wurde.
Die Schattierung wird in der Profilkonfigurationsdatei (PCF) konfiguriert, die einen Dokumenttyp unterstützt. Weitere Details finden Sie in den Informationen zum Attribut shadingBackground des Elements Profile.
Nachdem die Schattierung in der PCF-Datei konfiguriert wurde, kann sie mit dem Ansichtsbefehl set showprofileshading für ein Dokument aktiviert werden. Die Schattierung wird an folgenden Stellen angezeigt:
• Im Dialogfenster
Profile anwenden – Profilgruppen, Unterkategorien und Werte werden in der Farbe angezeigt, die ihnen in der PCF-Datei zugeordnet ist.
Sichtbar, wenn Sie das Dialogfenster von der Bearbeitungsansicht aus aufrufen, in der die Profilschattierung aktiviert ist, und wenn Schattierungsattribute für das Profil festgelegt sind.
• In einem der PCF-Datei zugeordneten Dokument – Elemente mit Profilwerten, denen in der PCF-Datei eine Schattierungsfarbe zugeordnet ist, werden in der Bearbeitungsansicht in dieser Farbe dargestellt. In der Strukturansicht und der Spaltenansicht der Dokumente wird außerdem ein Symbol

für Elemente mit Profil angezeigt.
Zusätzlich zu Farben für Profil, Profilgruppen und einzelne Werte können Sie auch eine Farbe festlegen, die für Profilkollisionen für den Dokumenttyp verwendet werden soll. Ein Element wird in dieser Farbe dargestellt, wenn ihm mehrere Profilwerte unterschiedlicher Farben zugewiesen wurden. Konfigurieren Sie die Kollisionsfarbe über das Attribut conflictShadingBackground des Elements ProfileClasses in der PCF-Datei.
Beachten Sie die folgenden Implementierungshinweise für die Profilschattierung:
• Eine für den Haupt-Profilalias konfigurierte Farbe wird als Standardfarbe betrachtet. Alle Profilwerte, für die keine eigene Profilschattierung angegeben wurde, verwenden die Standardfarbe.
• Wenn eine Farbe für eine Profilunterkategorie (Ordner) konfiguriert wurde, verwenden alle Werte in dem Ordner, für die keine eigene Profilschattierung konfiguriert wurde, die Ordnerfarbe.
• Wenn für zwei Profilwerte die gleiche Farbe angegeben wurde, wird dies nicht als Kollision betrachtet.
• In einer Tabelle kann eine Kollision auftreten, wenn ein Hintergrundfarbsatz, der durch die Profilzuweisung für Vorgänger-Tags festgelegt wurde, mit dem betreffenden Satz für eine einzelne Zelle übereinstimmt. In diesem Fall erbt die Zelle die Hintergrundfarbe, wenn das Kennzeichen force aktiviert ist. Andernfalls wird die zelleneigene Schattierung angezeigt.
Das Kennzeichen force wird aktiviert, wenn eine Schattierungsfarbe über die Profilschattierung festgelegt wurde. Die Farbe der Zelle wird überschrieben. Dies bedeutet auch, dass die Profilschattierung jegliche Inhalte überschreibt, mit denen ebenfalls eine Schattierung festlegt wird.
In der Strukturansicht wird das Tabellensymbol nicht durch das Profilsymbol überschrieben. Für diese Tags, für die explizit ein Profil festgelegt ist, wird auch der Tag-Name einschließlich des Tabellen-Tags auf die Profilschattierungsfarbe festgelegt.
• Beim Arbeiten mit DITA-Topics und -Maps werden die Effekte der DITA-Attributüberlappung nicht von der Profilschattierung angezeigt. Wenn beispielsweise für ein Elternteil das Profilzuweisungsattribut audience="novice" und für ein Kind-Element das Profilzuweisungsattribut audience="expert" festgelegt ist, ist für das Kind tatsächlich das Attribut audience="novice expert" festgelegt, das keine Schattierungsfarbe aufweisen kann.
Die folgenden Funktionen unterstützen die Profilschattierung:
• 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()