کار با تم‌های سند
کار با تم‌های سند
این راهنما نشان می‌دهد چگونه طرح رنگ و قلم را که اسناد ورد با سایر برنامه‌های آفیس به اشتراک می‌گذارند — تم سند — بخوانید و سفارشی کنید با استفاده از Theme, ThemeColors، و ThemeFonts in Aspose.Words FOSS برای .NET. تم یک سند، پالت و ترکیب قلمی است که قالب‌بندی آگاه از تم در سایر نقاط مدل شیء به آن ارجاع می‌دهد به جای سخت‌کدنویسی یک رنگ یا نام قلم خاص.
شیء تم
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 مقدار enum (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 هرکدام یک مقدار enum ThemeFont (Major، Minor یا None) را نگه می‌دارند که تعیین می‌کند آیا یک شیء Font خاص به Theme.MajorFonts یا Theme.MinorFonts برای یک بازه اسکریپت خاص ارجاع می‌دهد، به جای اینکه نام قلم صریح خود را ذخیره کند.
نکات و بهترین روش‌ها
- یک رنگ را در تمام حاشیه‌ها، سایه‌گذاری‌ها، پرکردن‌ها و قلم‌های حساس به تم به‌صورت یک‌بار تغییر دهید با به‌روزرسانی ویژگی
ThemeColorsمربوطه درDocument.Theme.Colors، به‌جای اینکه سند را پیمایش کنید و هر شیء قالب‌بندی را به‌صورت جداگانه به‌روزرسانی کنید. - قبل از اینکه فرض کنید شیء قالب‌بندی به تم ارجاع می‌دهد، بررسی کنید که آیا ویژگی
ThemeColorیاThemeFontآنNoneاست —Noneبه این معنی است که به‌جای آن نام صریحColorیا قلم خود را دارد. Theme.MajorFontsمعمولاً قلم‌های عنوان وTheme.MinorFontsقلم‌های بدنه را فراهم می‌کند، که با انتخاب‌کننده قلم تم خود ورد مطابقت دارد.
مشکلات رایج
| مشکل | دلیل | رفع |
|---|---|---|
تغییر Document.Theme.Colors.Accent1 بر پر کردن شکل تأثیری ندارد | Fill.ForeThemeColor شکل ThemeColor.None است، بنابراین به‌جای یک اسلات تم، از یک رنگ صریح استفاده می‌کند | Fill.ForeThemeColor را به مقدار ThemeColor موردنظر تنظیم کنید تا به تم ارجاع دهد |
فونت رندر شدهٔ Font با Theme.MajorFonts.Latin مطابقت ندارد | Font.ThemeFont (یا نسخهٔ مخصوص اسکریپت) ThemeFont.None است، بنابراین به‌جای آن نام خود فونت استفاده می‌شود | خاصیتThemeFontمربوطه را بهMajorیاMinorتنظیم کنید |
FAQ
چگونه می‌توان رنگ‌های تم یک سند را خواند؟
Read 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
| کلاس / شمارش | توضیح |
|---|---|
Theme | تم سند، از طریق Document.Theme؛ MajorFonts، MinorFonts، Colors |
ThemeColors | دوازده اسلات تم Color: Dark1، Light1، Dark2، Light2، Accent1-Accent6، Hyperlink، FollowedHyperlink |
ThemeFonts | نام‌های قلم تم بر حسب اسکریپت: Latin، EastAsian، ComplexScript |
ThemeColor | enum شناسایی‌کنندهٔ یک اسلات رنگ تم؛ مورد استفاده توسط Border، Shading، Fill، Stroke، Font |
ThemeFont | Enum شناسایی استفاده از فونت تم Major/Minor؛ استفاده شده توسط Font |
