Práce s tématy dokumentu

Práce s motivy dokumentů

Tato příručka ukazuje, jak číst a přizpůsobovat barevné a písmové schéma, které Word dokumenty sdílejí s ostatními aplikacemi Office – téma dokumentu – pomocí Theme, ThemeColors, a ThemeFonts in Aspose.Words FOSS pro .NET. Téma dokumentu je paleta a párování písem, na které se theme-aware formátování jinde v objektovém modelu odkazuje místo toho, aby bylo pevně zakódováno konkrétní barva nebo název písma.

Objekt motivu

Document.Theme vrací instanci Theme pro dokument. Theme.Colors je objekt ThemeColors, který obsahuje dvanáct tématických barev dokumentu; Theme.MajorFonts a Theme.MinorFonts jsou objekty ThemeFonts, které obsahují sady písem pro nadpisy a tělo textu.

Barvy motivu

ThemeColors zpřístupňuje dvanáct zapisovatelných Color vlastností: Dark1, Light1, Dark2, Light2, Accent1 through Accent6, Hyperlink, a FollowedHyperlink. Formátovací objekty jinde v dokumentu – Border.ThemeColor, Shading.ForegroundPatternThemeColor / BackgroundPatternThemeColor, Fill.ForeThemeColor / BackThemeColor, Stroke.ForeThemeColor / BackThemeColor, a Font.ThemeColor – držet ThemeColor enum hodnota (Dark1, Light1, Dark2, Light2, Accent1-Accent6, Hyperlink, FollowedHyperlink, plus Text1, Text2, Background1, Background2, a None) která identifikuje which slot barvy motivu se použije; skutečná Color hodnota pro tento slot pochází z odpovídající ThemeColors vlastnost zapnuto Document.Theme.Colors.

Písma motivu

ThemeFonts zveřejňuje tři zapisovatelné string vlastnosti: Latin (pro znaky latinské abecedy), EastAsian a ComplexScript – názvy písem používané pro každý skript, když formátovací objekt odkazuje na téma. Font.ThemeFont, ThemeFontAscii, ThemeFontFarEast, ThemeFontOther a ThemeFontBi každá obsahuje ThemeFont výčtovou (enum) hodnotu (Major, Minor nebo None) určující, zda daný Font objekt odkazuje na Theme.MajorFonts nebo Theme.MinorFonts pro konkrétní rozsah skriptů, místo aby si ukládal vlastní explicitní název písma.

Tipy a osvědčené postupy

• Změňte barvu ve všech okrajích, stínech, výplních a písmech, které jsou citlivé na téma, najednou úpravou příslušné ThemeColors vlastnosti na Document.Theme.Colors, místo abyste procházeli dokument a aktualizovali každý formátovací objekt jednotlivě.
• Zkontrolujte, zda je vlastnost ThemeColor nebo ThemeFont formátovacího objektu None, než předpokládáte, že odkazuje na téma – None znamená, že obsahuje vlastní explicitní Color nebo název písma.
• Theme.MajorFonts typicky poskytuje písma pro nadpisy a Theme.MinorFonts písma pro tělo, což odpovídá výběru písma v tématu ve Wordu.

Běžné problémy

FAQ

Jak načtu barvy tématu dokumentu?

Přečtěte Document.Theme.Colors, objekt ThemeColors s Color vlastnostmi pro každé ze dvanácti slotů barev motivu – Dark1, Light1, Dark2, Light2, Accent1-Accent6, Hyperlink a FollowedHyperlink.

Jak mohu změnit akcentní barvu dokumentu všude, kde je použita?

Nastavte Document.Theme.Colors.Accent1 (nebo kterýkoli akcentní slot) na novou Color; každý formátovací objekt, jehož vlastnost ThemeColor odkazuje na tento slot, přijme změnu.

Jaký je rozdíl mezi ThemeColors a ThemeColor?

ThemeColors (na Document.Theme.Colors) je objekt, který drží dvanáct skutečných hodnot Color pro dokument. ThemeColor je výčet (enum) používaný jinde (Border, Shading, Fill, Stroke, Font) k odkazu na jeden z těchto slotů podle názvu místo přímého ukládání barvy.

Jak nastavit, které písmo motivu používá objekt Font?

Nastavte Font.ThemeFont (nebo skriptově specifické ThemeFontAscii / ThemeFontFarEast / ThemeFontOther / ThemeFontBi) na ThemeFont.Major nebo ThemeFont.Minor; skutečný název písma pak pochází z Document.Theme.MajorFonts nebo MinorFonts.

API Reference Shrnutí

Viz také:

• Aspose.Words for .NET — Enterprise Documentation