Dokumentum témák kezelése

Dokumentsémákkal való munka

Ez az útmutató bemutatja, hogyan olvasható és testreszabható a szín- és betűtípus-séma, amelyet a Word-dokumentumok megosztanak más Office-alkalmazásokkal – a dokumentum témája – használva Theme, ThemeColors, és ThemeFonts in Aspose.Words FOSS a .NET számára. Egy dokumentum témája a paletta és a betűtípus párosítása, amelyre a témára érzékeny formázás az objektummodell más részein hivatkozik, ahelyett, hogy konkrét színt vagy betűtípusnevet kódolna be.

A témaobjektum

Document.Theme egy Theme példányt ad vissza a dokumentumhoz. Theme.Colors egy ThemeColors objektum, amely a dokumentum tizenkét témaszínét tartalmazza; Theme.MajorFonts és Theme.MinorFonts ThemeFonts objektumok, amelyek a címsor és a törzsszöveg betűkészleteit tárolják.

Témaszínek

ThemeColors tizenkét írható Color tulajdonságok: Dark1, Light1, Dark2, Light2, Accent1 through Accent6, Hyperlink, és FollowedHyperlink. Formázási objektumok a dokumentum más részein – Border.ThemeColor, Shading.ForegroundPatternThemeColor / BackgroundPatternThemeColor, Fill.ForeThemeColor / BackThemeColor, Stroke.ForeThemeColor / BackThemeColor, és Font.ThemeColor – tart egy ThemeColor enum érték (Dark1, Light1, Dark2, Light2, Accent1-Accent6, Hyperlink, FollowedHyperlink, plusz Text1, Text2, Background1, Background2, és None) amely azonosít which theme color slot alkalmazandó; a tényleges Color érték a slot-hoz a megfelelő ThemeColors tulajdonság be Document.Theme.Colors.

Témabetűk

ThemeFonts három írható string tulajdonságot tesz elérhetővé: Latin (latin betűs karakterekhez), EastAsian és ComplexScript — a betűtípusnevek, amelyeket minden írásrendszerhez használ, ha egy formázó objektum a témára hivatkozik. Font.ThemeFont, ThemeFontAscii, ThemeFontFarEast, ThemeFontOther és ThemeFontBi mindegyike egy ThemeFont enum értéket tartalmaz (Major, Minor vagy None), amely meghatározza, hogy egy adott Font objektum a Theme.MajorFonts vagy a Theme.MinorFonts felé hivatkozik-e egy bizonyos írásrendszer tartományban, ahelyett, hogy saját explicit betűtípusnevet tárolna.

Tippek és bevált gyakorlatok

Módosíts egy színt minden témára érzékeny keret, árnyékolás, kitöltés és betűtípus esetén egyetlen szerkesztéssel, a megfelelő ThemeColors tulajdonság frissítésével a Document.Theme.Colors objektumon, ahelyett, hogy végigmenne a dokumentumon, és egyenként frissítené a formázó objektumokat.
Ellenőrizd, hogy egy formázó objektum ThemeColor vagy ThemeFont tulajdonsága None-e, mielőtt azt feltételeznéd, hogy a témára hivatkozik — a None azt jelenti, hogy saját explicit Color vagy betűtípusnevet tartalmaz helyette.
Theme.MajorFonts általában a címsor betűtípusait, a Theme.MinorFonts pedig a törzs betűtípusait biztosítja, összhangban a Word saját téma betűtípusválasztójával.

Gyakori problémák

Probléma	Ok	Javítás
A `Document.Theme.Colors.Accent1` módosítása nem befolyásolja az alakzat kitöltését	Az alakzat `Fill.ForeThemeColor` értéke `ThemeColor.None`, ezért explicit színt használ a témahelyett	Állítsa be a `Fill.ForeThemeColor` értékét a kívánt `ThemeColor` értékre, hogy a téma szerint működjön
A `Font` renderelt betűtípusa nem egyezik `Theme.MajorFonts.Latin`-vel	A `Font.ThemeFont` (vagy a szkript-specifikus változat) `ThemeFont.None`, ezért a betűtípus saját neve kerül felhasználásra helyette	Állítsa be a megfelelő `ThemeFont` tulajdonságot `Major` vagy `Minor` értékre.

FAQ

Hogyan olvashatom el egy dokumentum téma színeit?

Olvasd Document.Theme.Colors, egy ThemeColors objektumot, amely Color tulajdonságokkal rendelkezik a tizenkét téma színhelyhez – Dark1, Light1, Dark2, Light2, Accent1-Accent6, Hyperlink és FollowedHyperlink.

Hogyan változtathatom meg a dokumentum kiemelő színét mindenhol, ahol használják?

Állítsd be a Document.Theme.Colors.Accent1 (vagy a kívánt akcentushely) új Color értékre; minden formázó objektum, amelynek ThemeColor tulajdonsága erre a helyre hivatkozik, felveszi a változást.

Mi a különbség a `ThemeColors` és a `ThemeColor` között?

ThemeColors (Document.Theme.Colors) az az objektum, amely a dokumentum számára a tizenkét tényleges Color értéket tárolja. ThemeColor egy felsorolt típus (enum), amelyet máshol használnak (Border, Shading, Fill, Stroke, Font) arra, hogy név szerint hivatkozzanak egy ilyen helyre a szín közvetlen tárolása helyett.

Hogyan állíthatom be, hogy melyik témabeli betűtípust használja a `Font` objektum?

Állítsd be a Font.ThemeFont (vagy a szkript-specifikus ThemeFontAscii / ThemeFontFarEast / ThemeFontOther / ThemeFontBi) ThemeFont.Major vagy ThemeFont.Minor értékre; a tényleges betűtípus neve ezután a Document.Theme.MajorFonts vagy MinorFonts alapján kerül meghatározásra.

API Reference Összegzés

Osztály / Enumeráció	Leírás
`Theme`	Dokumentum téma, a `Document.Theme` segítségével; `MajorFonts`, `MinorFonts`, `Colors`
`ThemeColors`	Tiz `Color` témahely: `Dark1`, `Light1`, `Dark2`, `Light2`, `Accent1`-`Accent6`, `Hyperlink`, `FollowedHyperlink`
`ThemeFonts`	Téma betűtípusnevek szkript szerint: `Latin`, `EastAsian`, `ComplexScript`
`ThemeColor`	Enum, amely egy témaszín slotot azonosít; a következők használják: `Border`, `Shading`, `Fill`, `Stroke`, `Font`
`ThemeFont`	Az `Major`/`Minor` téma betűtípus használatát azonosító enum; `Font` által használt.

Lásd még:

Aspose.Words for .NET — Enterprise Documentation