Робота з темами документа

Робота з темами документів

У цьому посібнику показано, як читати та налаштовувати схему кольорів і шрифтів, яку документи Word спільно використовують з іншими додатками Office — тему документа — за допомогою Theme, ThemeColors, та ThemeFonts in Aspose.Words FOSS для .NET. Тема документа — це палітра та поєднання шрифтів, до яких звертається форматування, орієнтоване на тему, в інших частинах об’єктної моделі, замість жорсткого кодування конкретного кольору або назви шрифту.

Об’єкт Theme

Document.Theme повертає екземпляр Theme для документа. Theme.Colors — це об’єкт ThemeColors, що містить дванадцять кольорів теми документа; Theme.MajorFonts та Theme.MinorFonts — це об’єкти ThemeFonts, які відповідно містять набори шрифтів заголовків і основного тексту.

Кольори теми

ThemeColors надає дванадцять записуваних Color властивостей: Dark1, Light1, Dark2, Light2, Accent1 through Accent6, Hyperlink, та FollowedHyperlink. Об’єкти форматування в інших частинах документа — Border.ThemeColor, Shading.ForegroundPatternThemeColor / BackgroundPatternThemeColor, Fill.ForeThemeColor / BackThemeColor, Stroke.ForeThemeColor / BackThemeColor, і Font.ThemeColor – зберігати ThemeColor значення перерахування (Dark1, Light1, Dark2, Light2, Accent1-Accent6, Hyperlink, FollowedHyperlink, плюс Text1, Text2, Background1, Background2, і None) яке ідентифікує which слот кольору теми застосовується; фактичний Color значення для цього слоту береться з відповідного ThemeColors властивість увімкнено Document.Theme.Colors.

Шрифти теми

ThemeFonts надає три придатних до запису string властивості: Latin (для латинських символів), EastAsian та ComplexScript — назви шрифтів, що використовуються для кожного скрипту, коли об’єкт форматування делегує темі. Font.ThemeFont, ThemeFontAscii, ThemeFontFarEast, ThemeFontOther і ThemeFontBi кожен містить значення переліку ThemeFont (Major, Minor або None), що визначає, чи даний об’єкт Font делегує Theme.MajorFonts або Theme.MinorFonts для певного діапазону скрипту, замість зберігання власної явної назви шрифту.

Поради та найкращі практики

• Змініть колір у всіх межах, затіненнях, заповненнях та шрифтах, що враховують тему, одним редагуванням, оновивши відповідну властивість ThemeColors у Document.Theme.Colors, замість того, щоб переглядати документ і оновлювати кожен об’єкт форматування окремо.
• Перевірте, чи властивість ThemeColor або ThemeFont об’єкта форматування є None, перш ніж припускати, що вона делегує темі — None означає, що вона містить власний явний Color або назву шрифту.
• Theme.MajorFonts зазвичай постачає шрифти заголовків, а Theme.MinorFonts — шрифти основного тексту, відповідаючи вибору теми шрифтів у Word.

Поширені проблеми

FAQ

Як прочитати кольори теми документа?

Прочитайте Document.Theme.Colors, об’єкт ThemeColors з властивостями Color для кожного з дванадцяти слотів кольорів теми – Dark1, Light1, Dark2, Light2, Accent1-Accent6, Hyperlink і FollowedHyperlink.

Як змінити акцентний колір документа скрізь, де він використовується?

Встановіть Document.Theme.Colors.Accent1 (або будь-який слот акценту) у новий Color; кожен об’єкт форматування, у якого властивість ThemeColor посилається на цей слот, отримує зміну.

У чому різниця між ThemeColors та ThemeColor?

ThemeColors (на Document.Theme.Colors) — це об’єкт, який містить дванадцять фактичних значень Color для документа. ThemeColor — це enum, який використовується в інших місцях (Border, Shading, Fill, Stroke, Font) для посилання на один із цих слотів за назвою, а не для збереження кольору безпосередньо.

Як встановити, який шрифт теми використовує об’єкт Font?

Встановіть Font.ThemeFont (або скриптово-специфічні ThemeFontAscii / ThemeFontFarEast / ThemeFontOther / ThemeFontBi) у ThemeFont.Major або ThemeFont.Minor; фактична назва шрифту тоді береться з Document.Theme.MajorFonts або MinorFonts.

API Reference Підсумок

Дивіться також

• Aspose.Words for .NET — Enterprise Documentation